<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- This manual is for GNU Hyperbole
(Edition 7.1.4, Published March, 2021).

Copyright (C) 1989-2021  Free Software Foundation, Inc.

Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3 or
any later version published by the Free Software Foundation.


GNU Hyperbole sofware is distributed under the terms of the GNU
General Public License version 3 or later, as published by the Free
Software Foundation, Inc.

GNU Hyperbole is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY, without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

See the GNU General Public License for more details in the file,
"COPYING", within the Hyperbole package directory. -->
<!-- Created by GNU Texinfo 6.5, http://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>GNU Hyperbole Manual</title>

<meta name="description" content="GNU Hyperbole Manual">
<meta name="keywords" content="GNU Hyperbole Manual">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<link href="#Top" rel="start" title="Top">
<link href="#Key-Index" rel="index" title="Key Index">
<link href="#SEC_Contents" rel="contents" title="Table of Contents">
<link href="dir.html#Top" rel="up" title="(dir)">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.indentedblock {margin-right: 0em}
blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
div.smalllisp {margin-left: 3.2em}
kbd {font-style: oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
pre.smalldisplay {font-family: inherit; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: inherit; font-size: smaller}
pre.smalllisp {font-size: smaller}
span.nolinebreak {white-space: nowrap}
span.roman {font-family: initial; font-weight: normal}
span.sansserif {font-family: sans-serif; font-weight: normal}
ul.no-bullet {list-style: none}
-->
</style>
<link rel="stylesheet" type="text/css" href="hyperbole.css">


</head>

<body lang="en">
<h1 class="settitle" align="center">GNU Hyperbole Manual</h1>















<a name="SEC_Overview"></a>
<h2 class="shortcontents-heading">Short Table of Contents</h2>

<div class="shortcontents">
<ul class="no-bullet">
<li><a name="stoc-GNU-Hyperbole" href="#toc-GNU-Hyperbole">GNU Hyperbole</a></li>
<li><a name="stoc-Introduction-1" href="#toc-Introduction-1">1 Introduction</a></li>
<li><a name="stoc-Smart-Keys-1" href="#toc-Smart-Keys-1">2 Smart Keys</a></li>
<li><a name="stoc-Buttons-1" href="#toc-Buttons-1">3 Buttons</a></li>
<li><a name="stoc-Menus-1" href="#toc-Menus-1">4 Menus</a></li>
<li><a name="stoc-HyControl-1" href="#toc-HyControl-1">5 HyControl</a></li>
<li><a name="stoc-Koutliner-1" href="#toc-Koutliner-1">6 Koutliner</a></li>
<li><a name="stoc-HyRolo-1" href="#toc-HyRolo-1">7 HyRolo</a></li>
<li><a name="stoc-Window-Configurations-1" href="#toc-Window-Configurations-1">8 Window Configurations</a></li>
<li><a name="stoc-Developing-with-Hyperbole-1" href="#toc-Developing-with-Hyperbole-1">9 Developing with Hyperbole</a></li>
<li><a name="stoc-Glossary-1" href="#toc-Glossary-1">Appendix A Glossary</a></li>
<li><a name="stoc-Setup-1" href="#toc-Setup-1">Appendix B Setup</a></li>
<li><a name="stoc-Global-Key-Bindings-1" href="#toc-Global-Key-Bindings-1">Appendix C Global Key Bindings</a></li>
<li><a name="stoc-Koutliner-Keys-1" href="#toc-Koutliner-Keys-1">Appendix D Koutliner Keys</a></li>
<li><a name="stoc-Smart-Key-Reference-1" href="#toc-Smart-Key-Reference-1">Appendix E Smart Key Reference</a></li>
<li><a name="stoc-Suggestion-or-Bug-Reporting-1" href="#toc-Suggestion-or-Bug-Reporting-1">Appendix F Suggestion or Bug Reporting</a></li>
<li><a name="stoc-Questions-and-Answers-1" href="#toc-Questions-and-Answers-1">Appendix G Questions and Answers</a></li>
<li><a name="stoc-Future-Work-1" href="#toc-Future-Work-1">Appendix H Future Work</a></li>
<li><a name="stoc-References-1" href="#toc-References-1">Appendix I References</a></li>
<li><a name="stoc-Key-Index-1" href="#toc-Key-Index-1">Key Index</a></li>
<li><a name="stoc-Function_002c-Variable-and-File-Index" href="#toc-Function_002c-Variable-and-File-Index">Function, Variable and File Index</a></li>
<li><a name="stoc-Concept-Index-1" href="#toc-Concept-Index-1">Concept Index</a></li>

</ul>
</div>

<a name="SEC_Contents"></a>
<h2 class="contents-heading">Table of Contents</h2>

<div class="contents">
<ul class="no-bullet">
<li><a name="toc-GNU-Hyperbole" href="#Top">GNU Hyperbole</a></li>
<li><a name="toc-Introduction-1" href="#Introduction">1 Introduction</a>
<ul class="no-bullet">
  <li><a name="toc-Manual-Overview-1" href="#Manual-Overview">1.1 Manual Overview</a></li>
  <li><a name="toc-Motivation-1" href="#Motivation">1.2 Motivation</a></li>
  <li><a name="toc-Hyperbole-Overview-1" href="#Hyperbole-Overview">1.3 Hyperbole Overview</a></li>
  <li><a name="toc-Mail-Lists-1" href="#Mail-Lists">1.4 Mail Lists</a></li>
</ul></li>
<li><a name="toc-Smart-Keys-1" href="#Smart-Keys">2 Smart Keys</a>
<ul class="no-bullet">
  <li><a name="toc-Smart-Key-Bindings-1" href="#Smart-Key-Bindings">2.1 Smart Key Bindings</a></li>
  <li><a name="toc-Smart-Key-Operations-1" href="#Smart-Key-Operations">2.2 Smart Key Operations</a></li>
  <li><a name="toc-Smart-Key-Argument-Selection-1" href="#Smart-Key-Argument-Selection">2.3 Smart Key Argument Selection</a></li>
  <li><a name="toc-Smart-Key-Debugging-1" href="#Smart-Key-Debugging">2.4 Smart Key Debugging</a></li>
  <li><a name="toc-Smart-Key-Thing-Selection-1" href="#Smart-Key-Thing-Selection">2.5 Smart Key Thing Selection</a></li>
  <li><a name="toc-Smart-Mouse-Key-Modeline-Clicks-1" href="#Smart-Mouse-Key-Modeline-Clicks">2.6 Smart Mouse Key Modeline Clicks</a></li>
  <li><a name="toc-Smart-Mouse-Key-Drags-1" href="#Smart-Mouse-Key-Drags">2.7 Smart Mouse Key Drags</a>
  <ul class="no-bullet">
    <li><a name="toc-Creating-and-Deleting-Windows-1" href="#Creating-and-Deleting-Windows">2.7.1 Creating and Deleting Windows</a></li>
    <li><a name="toc-Saving-and-Restoring-Window-Configurations-1" href="#Saving-and-Restoring-Window-Configurations">2.7.2 Saving and Restoring Window Configurations</a></li>
    <li><a name="toc-Resizing-Windows-1" href="#Resizing-Windows">2.7.3 Resizing Windows</a></li>
    <li><a name="toc-Moving-Frames-1" href="#Moving-Frames">2.7.4 Moving Frames</a></li>
    <li><a name="toc-Dragging-Buffers_002c-Windows-and-Items" href="#Dragging-Buffers">2.7.5 Dragging Buffers, Windows and Items</a>
    <ul class="no-bullet">
      <li><a name="toc-Swapping-Buffers-1" href="#Swapping-Buffers">2.7.5.1 Swapping Buffers</a></li>
      <li><a name="toc-Displaying-Buffers-1" href="#Displaying-Buffers">2.7.5.2 Displaying Buffers</a></li>
      <li><a name="toc-Cloning-Windows-1" href="#Cloning-Windows">2.7.5.3 Cloning Windows</a></li>
      <li><a name="toc-Displaying-File-and-Buffer-Items-1" href="#Displaying-File-and-Buffer-Items">2.7.5.4 Displaying File and Buffer Items</a></li>
      <li><a name="toc-Keyboard-Drags-1" href="#Keyboard-Drags">2.7.5.5 Keyboard Drags</a></li>
    </ul></li>
  </ul></li>
</ul></li>
<li><a name="toc-Buttons-1" href="#Buttons">3 Buttons</a>
<ul class="no-bullet">
  <li><a name="toc-Explicit-Buttons-1" href="#Explicit-Buttons">3.1 Explicit Buttons</a></li>
  <li><a name="toc-Global-Buttons-1" href="#Global-Buttons">3.2 Global Buttons</a></li>
  <li><a name="toc-Implicit-Buttons-1" href="#Implicit-Buttons">3.3 Implicit Buttons</a>
  <ul class="no-bullet">
    <li><a name="toc-Implicit-Button-Types-1" href="#Implicit-Button-Types">3.3.1 Implicit Button Types</a></li>
    <li><a name="toc-Action-Buttons-1" href="#Action-Buttons">3.3.2 Action Buttons</a></li>
  </ul></li>
  <li><a name="toc-Button-Files-1" href="#Button-Files">3.4 Button Files</a></li>
  <li><a name="toc-Action-Types-1" href="#Action-Types">3.5 Action Types</a></li>
  <li><a name="toc-Button-Type-Precedence-1" href="#Button-Type-Precedence">3.6 Button Type Precedence</a></li>
  <li><a name="toc-Utilizing-Explicit-Buttons-1" href="#Utilizing-Explicit-Buttons">3.7 Utilizing Explicit Buttons</a>
  <ul class="no-bullet">
    <li><a name="toc-Creation-1" href="#Creation">3.7.1 Creation</a>
    <ul class="no-bullet">
      <li><a name="toc-Creation-Via-Action-Key-Drags" href="#By-Dragging">3.7.1.1 Creation Via Action Key Drags</a></li>
      <li><a name="toc-Creation-Via-Menus" href="#By-Menu">3.7.1.2 Creation Via Menus</a></li>
    </ul></li>
    <li><a name="toc-Renaming-1" href="#Renaming">3.7.2 Renaming</a></li>
    <li><a name="toc-Deletion-1" href="#Deletion">3.7.3 Deletion</a></li>
    <li><a name="toc-Modification-1" href="#Modification">3.7.4 Modification</a></li>
    <li><a name="toc-Searching-and-Summarizing-1" href="#Searching-and-Summarizing">3.7.5 Searching and Summarizing</a></li>
    <li><a name="toc-Buttons-in-Mail-1" href="#Buttons-in-Mail">3.7.6 Buttons in Mail</a></li>
    <li><a name="toc-Buttons-in-News-1" href="#Buttons-in-News">3.7.7 Buttons in News</a></li>
  </ul></li>
</ul></li>
<li><a name="toc-Menus-1" href="#Menus">4 Menus</a></li>
<li><a name="toc-HyControl-1" href="#HyControl">5 HyControl</a></li>
<li><a name="toc-Koutliner-1" href="#Koutliner">6 Koutliner</a>
<ul class="no-bullet">
  <li><a name="toc-Menu-Commands-1" href="#Menu-Commands">6.1 Menu Commands</a></li>
  <li><a name="toc-Creating-Outlines-1" href="#Creating-Outlines">6.2 Creating Outlines</a></li>
  <li><a name="toc-Autonumbering-1" href="#Autonumbering">6.3 Autonumbering</a></li>
  <li><a name="toc-Idstamps-1" href="#Idstamps">6.4 Idstamps</a></li>
  <li><a name="toc-Editing-1" href="#Editing">6.5 Editing</a>
  <ul class="no-bullet">
    <li><a name="toc-Adding-and-Killing-1" href="#Adding-and-Killing">6.5.1 Adding and Killing</a></li>
    <li><a name="toc-Relocating-and-Copying-1" href="#Relocating-and-Copying">6.5.2 Relocating and Copying</a></li>
    <li><a name="toc-Moving-Around-1" href="#Moving-Around">6.5.3 Moving Around</a></li>
    <li><a name="toc-Filling-1" href="#Filling">6.5.4 Filling</a></li>
    <li><a name="toc-Transposing-1" href="#Transposing">6.5.5 Transposing</a></li>
    <li><a name="toc-Splitting-and-Appending-1" href="#Splitting-and-Appending">6.5.6 Splitting and Appending</a></li>
    <li><a name="toc-Inserting-and-Importing-1" href="#Inserting-and-Importing">6.5.7 Inserting and Importing</a></li>
    <li><a name="toc-Exporting-1" href="#Exporting">6.5.8 Exporting</a></li>
  </ul></li>
  <li><a name="toc-Viewing-1" href="#Viewing">6.6 Viewing</a>
  <ul class="no-bullet">
    <li><a name="toc-Hiding-and-Showing-1" href="#Hiding-and-Showing">6.6.1 Hiding and Showing</a></li>
    <li><a name="toc-View-Specs-1" href="#View-Specs">6.6.2 View Specs</a></li>
  </ul></li>
  <li><a name="toc-Links-1" href="#Links">6.7 Links</a></li>
  <li><a name="toc-Cell-Attributes-1" href="#Cell-Attributes">6.8 Cell Attributes</a></li>
  <li><a name="toc-Koutliner-History-1" href="#Koutliner-History">6.9 Koutliner History</a></li>
</ul></li>
<li><a name="toc-HyRolo-1" href="#HyRolo">7 HyRolo</a>
<ul class="no-bullet">
  <li><a name="toc-HyRolo-Concepts-1" href="#HyRolo-Concepts">7.1 HyRolo Concepts</a></li>
  <li><a name="toc-Rolo-Menu" href="#HyRolo-Menu">7.2 Rolo Menu</a></li>
  <li><a name="toc-HyRolo-Searching-1" href="#HyRolo-Searching">7.3 HyRolo Searching</a></li>
  <li><a name="toc-HyRolo-Keys-1" href="#HyRolo-Keys">7.4 HyRolo Keys</a></li>
  <li><a name="toc-HyRolo-Settings-1" href="#HyRolo-Settings">7.5 HyRolo Settings</a></li>
</ul></li>
<li><a name="toc-Window-Configurations-1" href="#Window-Configurations">8 Window Configurations</a></li>
<li><a name="toc-Developing-with-Hyperbole-1" href="#Developing-with-Hyperbole">9 Developing with Hyperbole</a>
<ul class="no-bullet">
  <li><a name="toc-Hook-Variables-1" href="#Hook-Variables">9.1 Hook Variables</a></li>
  <li><a name="toc-Creating-Types-1" href="#Creating-Types">9.2 Creating Types</a>
  <ul class="no-bullet">
    <li><a name="toc-Creating-Action-Types-1" href="#Creating-Action-Types">9.2.1 Creating Action Types</a></li>
    <li><a name="toc-Creating-Implicit-Button-Types-1" href="#Creating-Implicit-Button-Types">9.2.2 Creating Implicit Button Types</a>
    <ul class="no-bullet">
      <li><a name="toc-Action-Button-Link-Types-1" href="#Action-Button-Link-Types">9.2.2.1 Action Button Link Types</a></li>
      <li><a name="toc-Implicit-Button-Link-Types-1" href="#Implicit-Button-Link-Types">9.2.2.2 Implicit Button Link Types</a></li>
      <li><a name="toc-Programmatic-Implicit-Button-Types-1" href="#Programmatic-Implicit-Button-Types">9.2.2.3 Programmatic Implicit Button Types</a></li>
    </ul></li>
  </ul></li>
  <li><a name="toc-Explicit-Button-Technicalities-1" href="#Explicit-Button-Technicalities">9.3 Explicit Button Technicalities</a>
  <ul class="no-bullet">
    <li><a name="toc-Button-Label-Normalization-1" href="#Button-Label-Normalization">9.3.1 Button Label Normalization</a></li>
    <li><a name="toc-Operational-and-Storage-Formats-1" href="#Operational-and-Storage-Formats">9.3.2 Operational and Storage Formats</a></li>
    <li><a name="toc-Programmatic-Button-Creation-1" href="#Programmatic-Button-Creation">9.3.3 Programmatic Button Creation</a></li>
  </ul></li>
  <li><a name="toc-Encapsulating-Systems-1" href="#Encapsulating-Systems">9.4 Encapsulating Systems</a></li>
  <li><a name="toc-Embedding-Hyperbole-1" href="#Embedding-Hyperbole">9.5 Embedding Hyperbole</a></li>
</ul></li>
<li><a name="toc-Glossary-1" href="#Glossary">Appendix A Glossary</a></li>
<li><a name="toc-Setup-1" href="#Setup">Appendix B Setup</a>
<ul class="no-bullet">
  <li><a name="toc-Installation-1" href="#Installation">B.1 Installation</a></li>
  <li><a name="toc-Invocation-1" href="#Invocation">B.2 Invocation</a></li>
  <li><a name="toc-Customization-1" href="#Customization">B.3 Customization</a>
  <ul class="no-bullet">
    <li><a name="toc-Referent-Display-1" href="#Referent-Display">B.3.1 Referent Display</a></li>
    <li><a name="toc-Internal-Viewers-1" href="#Internal-Viewers">B.3.2 Internal Viewers</a></li>
    <li><a name="toc-External-Viewers-1" href="#External-Viewers">B.3.3 External Viewers</a></li>
    <li><a name="toc-Link-Variable-Substitution-1" href="#Link-Variable-Substitution">B.3.4 Link Variable Substitution</a></li>
    <li><a name="toc-Web-Search-Engines-1" href="#Web-Search-Engines">B.3.5 Web Search Engines</a></li>
    <li><a name="toc-Using-URLs-with-Find_002dFile-1" href="#Using-URLs-with-Find_002dFile">B.3.6 Using URLs with Find-File</a></li>
    <li><a name="toc-Invisible-Text-Searches-1" href="#Invisible-Text-Searches">B.3.7 Invisible Text Searches</a></li>
    <li><a name="toc-Configuring-Button-Colors" href="#Button-Colors">B.3.8 Configuring Button Colors</a></li>
  </ul></li>
</ul></li>
<li><a name="toc-Global-Key-Bindings-1" href="#Global-Key-Bindings">Appendix C Global Key Bindings</a>
<ul class="no-bullet">
  <li><a name="toc-Binding-Minibuffer-Menu-Items-1" href="#Binding-Minibuffer-Menu-Items">C.1 Binding Minibuffer Menu Items</a></li>
  <li><a name="toc-Default-Global-Bindings-1" href="#Default-Global-Bindings">C.2 Default Global Bindings</a></li>
</ul></li>
<li><a name="toc-Koutliner-Keys-1" href="#Koutliner-Keys">Appendix D Koutliner Keys</a></li>
<li><a name="toc-Smart-Key-Reference-1" href="#Smart-Key-Reference">Appendix E Smart Key Reference</a>
<ul class="no-bullet">
  <li><a name="toc-Smart-Mouse-Keys-1" href="#Smart-Mouse-Keys">E.1 Smart Mouse Keys</a>
  <ul class="no-bullet">
    <li><a name="toc-Minibuffer-Menu-Activation-1" href="#Minibuffer-Menu-Activation">E.1.1 Minibuffer Menu Activation</a></li>
    <li><a name="toc-Thing-Selection-1" href="#Thing-Selection">E.1.2 Thing Selection</a></li>
    <li><a name="toc-Side_002dby_002dSide-Window-Resizing-1" href="#Side_002dby_002dSide-Window-Resizing">E.1.3 Side-by-Side Window Resizing</a></li>
    <li><a name="toc-Modeline-Clicks-and-Drags-1" href="#Modeline-Clicks-and-Drags">E.1.4 Modeline Clicks and Drags</a></li>
    <li><a name="toc-Smart-Mouse-Drags-between-Windows-1" href="#Smart-Mouse-Drags-between-Windows">E.1.5 Smart Mouse Drags between Windows</a></li>
    <li><a name="toc-Smart-Mouse-Drags-within-a-Window-1" href="#Smart-Mouse-Drags-within-a-Window">E.1.6 Smart Mouse Drags within a Window</a></li>
    <li><a name="toc-Smart-Mouse-Drags-outside-a-Window-1" href="#Smart-Mouse-Drags-outside-a-Window">E.1.7 Smart Mouse Drags outside a Window</a></li>
  </ul></li>
  <li><a name="toc-Smart-Keyboard-Keys-1" href="#Smart-Keyboard-Keys">E.2 Smart Keyboard Keys</a>
  <ul class="no-bullet">
    <li><a name="toc-Smart-Key-_002d-Company-Mode-1" href="#Smart-Key-_002d-Company-Mode">E.2.1 Smart Key - Company Mode</a></li>
    <li><a name="toc-Smart-Key-_002d-Treemacs-1" href="#Smart-Key-_002d-Treemacs">E.2.2 Smart Key - Treemacs</a></li>
    <li><a name="toc-Smart-Key-_002d-Dired-Sidebar-Mode-1" href="#Smart-Key-_002d-Dired-Sidebar-Mode">E.2.3 Smart Key - Dired Sidebar Mode</a></li>
    <li><a name="toc-Smart-Key-_002d-Emacs-Pushbuttons-1" href="#Smart-Key-_002d-Emacs-Pushbuttons">E.2.4 Smart Key - Emacs Pushbuttons</a></li>
    <li><a name="toc-Smart-Key-_002d-Argument-Completion-1" href="#Smart-Key-_002d-Argument-Completion">E.2.5 Smart Key - Argument Completion</a></li>
    <li><a name="toc-Smart-Key-_002d-ID-Edit-Mode-1" href="#Smart-Key-_002d-ID-Edit-Mode">E.2.6 Smart Key - ID Edit Mode</a></li>
    <li><a name="toc-Smart-Key-_002d-Emacs-Cross_002dreferences-_0028Xrefs_0029-1" href="#Smart-Key-_002d-Emacs-Cross_002dreferences-_0028Xrefs_0029">E.2.7 Smart Key - Emacs Cross-references (Xrefs)</a></li>
    <li><a name="toc-Smart-Key-_002d-Smart-Scrolling-1" href="#Smart-Key-_002d-Smart-Scrolling">E.2.8 Smart Key - Smart Scrolling</a></li>
    <li><a name="toc-Smart-Key-_002d-Smart-Menus-1" href="#Smart-Key-_002d-Smart-Menus">E.2.9 Smart Key - Smart Menus</a></li>
    <li><a name="toc-Smart-Key-_002d-Dired-Mode-1" href="#Smart-Key-_002d-Dired-Mode">E.2.10 Smart Key - Dired Mode</a></li>
    <li><a name="toc-Smart-Key-_002d-Hyperbole-Buttons-1" href="#Smart-Key-_002d-Hyperbole-Buttons">E.2.11 Smart Key - Hyperbole Buttons</a></li>
    <li><a name="toc-Smart-Key-_002d-View-Mode-1" href="#Smart-Key-_002d-View-Mode">E.2.12 Smart Key - View Mode</a></li>
    <li><a name="toc-Smart-Key-_002d-Helm-Mode-1" href="#Smart-Key-_002d-Helm-Mode">E.2.13 Smart Key - Helm Mode</a></li>
    <li><a name="toc-Smart-Key-_002d-Delimited-Things-1" href="#Smart-Key-_002d-Delimited-Things">E.2.14 Smart Key - Delimited Things</a></li>
    <li><a name="toc-Smart-Key-_002d-The-Koutliner-1" href="#Smart-Key-_002d-The-Koutliner">E.2.15 Smart Key - The Koutliner</a></li>
    <li><a name="toc-Smart-Key-_002d-RDB-Mode-1" href="#Smart-Key-_002d-RDB-Mode">E.2.16 Smart Key - RDB Mode</a></li>
    <li><a name="toc-Smart-Key-_002d-Help-Buffers-1" href="#Smart-Key-_002d-Help-Buffers">E.2.17 Smart Key - Help Buffers</a></li>
    <li><a name="toc-Smart-Key-_002d-Bookmark-Mode-1" href="#Smart-Key-_002d-Bookmark-Mode">E.2.18 Smart Key - Bookmark Mode</a></li>
    <li><a name="toc-Smart-Key-_002d-Pages-Directory-Mode-1" href="#Smart-Key-_002d-Pages-Directory-Mode">E.2.19 Smart Key - Pages Directory Mode</a></li>
    <li><a name="toc-Smart-Key-_002d-Python-Source-Code-1" href="#Smart-Key-_002d-Python-Source-Code">E.2.20 Smart Key - Python Source Code</a></li>
    <li><a name="toc-Smart-Key-_002d-Identifier-Menu-Mode-1" href="#Smart-Key-_002d-Identifier-Menu-Mode">E.2.21 Smart Key - Identifier Menu Mode</a></li>
    <li><a name="toc-Smart-Key-_002d-C-Source-Code-1" href="#Smart-Key-_002d-C-Source-Code">E.2.22 Smart Key - C Source Code</a></li>
    <li><a name="toc-Smart-Key-_002d-C_002b_002b-Source-Code-1" href="#Smart-Key-_002d-C_002b_002b-Source-Code">E.2.23 Smart Key - C++ Source Code</a></li>
    <li><a name="toc-Smart-Key-_002d-Assembly-Source-Code-1" href="#Smart-Key-_002d-Assembly-Source-Code">E.2.24 Smart Key - Assembly Source Code</a></li>
    <li><a name="toc-Smart-Key-_002d-Lisp-Source-Code-1" href="#Smart-Key-_002d-Lisp-Source-Code">E.2.25 Smart Key - Lisp Source Code</a></li>
    <li><a name="toc-Smart-Key-_002d-Java-Source-Code-1" href="#Smart-Key-_002d-Java-Source-Code">E.2.26 Smart Key - Java Source Code</a></li>
    <li><a name="toc-Smart-Key-_002d-JavaScript-Source-Code-1" href="#Smart-Key-_002d-JavaScript-Source-Code">E.2.27 Smart Key - JavaScript Source Code</a></li>
    <li><a name="toc-Smart-Key-_002d-Objective_002dC-Source-Code-1" href="#Smart-Key-_002d-Objective_002dC-Source-Code">E.2.28 Smart Key - Objective-C Source Code</a></li>
    <li><a name="toc-Smart-Key-_002d-Fortran-Source-Code-1" href="#Smart-Key-_002d-Fortran-Source-Code">E.2.29 Smart Key - Fortran Source Code</a></li>
    <li><a name="toc-Smart-Key-_002d-Occurrence-Matches-1" href="#Smart-Key-_002d-Occurrence-Matches">E.2.30 Smart Key - Occurrence Matches</a></li>
    <li><a name="toc-Smart-Key-_002d-Calendar-Mode-1" href="#Smart-Key-_002d-Calendar-Mode">E.2.31 Smart Key - Calendar Mode</a></li>
    <li><a name="toc-Smart-Key-_002d-Man-Page-Apropos-1" href="#Smart-Key-_002d-Man-Page-Apropos">E.2.32 Smart Key - Man Page Apropos</a></li>
    <li><a name="toc-Smart-Key-_002d-Emacs-Outline-Mode-1" href="#Smart-Key-_002d-Emacs-Outline-Mode">E.2.33 Smart Key - Emacs Outline Mode</a></li>
    <li><a name="toc-Smart-Key-_002d-Info-Manuals-1" href="#Smart-Key-_002d-Info-Manuals">E.2.34 Smart Key - Info Manuals</a></li>
    <li><a name="toc-Smart-Key-_002d-Email-Readers-1" href="#Smart-Key-_002d-Email-Readers">E.2.35 Smart Key - Email Readers</a></li>
    <li><a name="toc-Smart-Key-_002d-GNUS-Newsreader-1" href="#Smart-Key-_002d-GNUS-Newsreader">E.2.36 Smart Key - GNUS Newsreader</a></li>
    <li><a name="toc-Smart-Key-_002d-Buffer-Menus-1" href="#Smart-Key-_002d-Buffer-Menus">E.2.37 Smart Key - Buffer Menus</a></li>
    <li><a name="toc-Smart-Key-_002d-Tar-File-Mode-1" href="#Smart-Key-_002d-Tar-File-Mode">E.2.38 Smart Key - Tar File Mode</a></li>
    <li><a name="toc-Smart-Key-_002d-Man-Pages-1" href="#Smart-Key-_002d-Man-Pages">E.2.39 Smart Key - Man Pages</a></li>
    <li><a name="toc-Smart-Key-_002d-WWW-URLs-1" href="#Smart-Key-_002d-WWW-URLs">E.2.40 Smart Key - WWW URLs</a></li>
    <li><a name="toc-Smart-Key-_002d-HyRolo-Match-Buffers-1" href="#Smart-Key-_002d-HyRolo-Match-Buffers">E.2.41 Smart Key - HyRolo Match Buffers</a></li>
    <li><a name="toc-Smart-Key-_002d-Image-Thumbnails-1" href="#Smart-Key-_002d-Image-Thumbnails">E.2.42 Smart Key - Image Thumbnails</a></li>
    <li><a name="toc-Smart-Key-_002d-Gomoku-Game-1" href="#Smart-Key-_002d-Gomoku-Game">E.2.43 Smart Key - Gomoku Game</a></li>
    <li><a name="toc-Smart-Key-_002d-Magit-Mode-1" href="#Smart-Key-_002d-Magit-Mode">E.2.44 Smart Key - Magit Mode</a></li>
    <li><a name="toc-Smart-Key-_002d-The-OO_002dBrowser-1" href="#Smart-Key-_002d-The-OO_002dBrowser">E.2.45 Smart Key - The OO-Browser</a></li>
    <li><a name="toc-Smart-Key-_002d-Default-Context-1" href="#Smart-Key-_002d-Default-Context">E.2.46 Smart Key - Default Context</a></li>
  </ul></li>
</ul></li>
<li><a name="toc-Suggestion-or-Bug-Reporting-1" href="#Suggestion-or-Bug-Reporting">Appendix F Suggestion or Bug Reporting</a></li>
<li><a name="toc-Questions-and-Answers-1" href="#Questions-and-Answers">Appendix G Questions and Answers</a></li>
<li><a name="toc-Future-Work-1" href="#Future-Work">Appendix H Future Work</a></li>
<li><a name="toc-References-1" href="#References">Appendix I References</a></li>
<li><a name="toc-Key-Index-1" href="#Key-Index">Key Index</a></li>
<li><a name="toc-Function_002c-Variable-and-File-Index" href="#Function">Function, Variable and File Index</a></li>
<li><a name="toc-Concept-Index-1" href="#Concept-Index">Concept Index</a></li>

</ul>
</div>



<a name="Top"></a>
<div class="header">
<p>
Next: <a href="#Introduction" accesskey="n" rel="next">Introduction</a>, Previous: <a href="dir.html#Top" accesskey="p" rel="prev">(dir)</a>, Up: <a href="dir.html#Top" accesskey="u" rel="up">(dir)</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="GNU-Hyperbole"></a>
<h2 class="unnumbered">GNU Hyperbole</h2>

<CENTER><H1>GNU Hyperbole</H1></CENTER>

<CENTER><H2>The Everyday Hypertextual Information Manager</H2></CENTER>

<CENTER><H3><A HREF="mailto:rsw@gnu.org">Say thanks or send a testimonial if you like Hyperbole.</A></H3></CENTER>


<P>Copyright &copy; 1989-2021  Free Software Foundation, Inc.</P>

<P>GNU Hyperbole is available for use, modification, and distribution under
the terms of the GNU General Public License (GPL) Version 3 or later,
as published by the Free Software Foundation, with all rights and
responsibilities thereof.</P>

<P>GNU Hyperbole is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY, without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.</P>

<PRE>
Edition 7.1.4
Printed March 21, 2021.

  Published by the Free Software Foundation, Inc.
  Author:    Bob Weiner
  E-mail:    &lt;hyperbole-users@gnu.org&gt; (This is a mail list).
  Web:       www.gnu.org/software/hyperbole
</PRE>

<CENTER>
  <DT><B>Screenshot of the Hyperbole Koutliner, Demonstration and HyRolo</B></DT><BR><BR>
  <IMG NAME="Hyperbole Screenshot" SRC="im/hyperbole-cv.png"><BR>
</CENTER>
<br>
<div align="center">&mdash;&mdash;&mdash;&mdash;&mdash;&mdash;&ndash;
</div><br>


<a name="index-credits"></a>
<a name="index-Hyperbole_002c-obtaining"></a>
<a name="index-anonymous-ftp"></a>
<p>GNU Hyperbole was designed and written by Bob Weiner.
See <a href="#Setup">Setup</a>, for information on how to obtain and to install
Hyperbole.
</p>
<p>This manual explains user operation and summarizes basic developer
facilities of GNU Hyperbole.  Hyperbole provides convenient access
to information, control over its display and easy linking of items
across documents and across the web.  The Hyperbole Koutliner offers
flexible views and structure manipulation within bodies of
information.
</p>
<p>We hope you enjoy using Hyperbole and that it improves your
productivity.  If it does, consider sending us a quote or short note
discussing how it helps you.  We may use your submission to help
promote further use of Hyperbole; all submissions will be considered
freely reusable and will fall under the same license as Hyperbole.
E-mail your quote to &lt;hyperbole-users@gnu.org&gt;.  We volunteer our
time on Hyperbole and love to hear user stories in addition to any
problem reports.
</p>
<p>Before we delve into Hyperbole, a number of acknowledgments are in
order.  Peter Wegner and Morris Moore encouraged the growth of this
work.  Douglas Engelbart showed us the bigger picture and will forever
be an inspiration.  His life-long quest at augmenting individual and
team capabilities represents a model from which we continue to draw.
Chris Nuzum has used Hyperbole since its inception, often
demonstrating its power in creative ways.  Many thanks to Mats Lidell,
a long-time Hyperbole user, who has helped maintain it throughout the
years.  The Koutliner is dedicated to my lovely wife, Kathy.
</p>
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">&bull; <a href="#Introduction" accesskey="1">Introduction</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Keys" accesskey="2">Smart Keys</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Buttons" accesskey="3">Buttons</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Menus" accesskey="4">Menus</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#HyControl" accesskey="5">HyControl</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Koutliner" accesskey="6">Koutliner</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#HyRolo" accesskey="7">HyRolo</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Window-Configurations" accesskey="8">Window Configurations</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Developing-with-Hyperbole" accesskey="9">Developing with Hyperbole</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Glossary">Glossary</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Setup">Setup</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Global-Key-Bindings">Global Key Bindings</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Koutliner-Keys">Koutliner Keys</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-Reference">Smart Key Reference</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Suggestion-or-Bug-Reporting">Suggestion or Bug Reporting</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Questions-and-Answers">Questions and Answers</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Future-Work">Future Work</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#References">References</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Key-Index">Key Index</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Function">Function</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Concept-Index">Concept Index</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">

</pre></th></tr><tr><th colspan="3" align="left" valign="top"><pre class="menu-comment"> &mdash; The Detailed Node Listing &mdash;

Introduction

</pre></th></tr><tr><td align="left" valign="top">&bull; <a href="#Manual-Overview">Manual Overview</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Motivation">Motivation</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Hyperbole-Overview">Hyperbole Overview</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Mail-Lists">Mail Lists</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">

Smart Keys

</pre></th></tr><tr><td align="left" valign="top">&bull; <a href="#Smart-Key-Bindings">Smart Key Bindings</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-Operations">Smart Key Operations</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-Argument-Selection">Smart Key Argument Selection</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-Debugging">Smart Key Debugging</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-Thing-Selection">Smart Key Thing Selection</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Mouse-Key-Modeline-Clicks">Smart Mouse Key Modeline Clicks</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Mouse-Key-Drags">Smart Mouse Key Drags</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">

Smart Mouse Key Drags

</pre></th></tr><tr><td align="left" valign="top">&bull; <a href="#Creating-and-Deleting-Windows">Creating and Deleting Windows</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Saving-and-Restoring-Window-Configurations">Saving and Restoring Window Configurations</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Resizing-Windows">Resizing Windows</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Moving-Frames">Moving Frames</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Dragging-Buffers">Dragging Buffers</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">

Dragging Buffers, Windows and Items

</pre></th></tr><tr><td align="left" valign="top">&bull; <a href="#Swapping-Buffers">Swapping Buffers</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Displaying-Buffers">Displaying Buffers</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Cloning-Windows">Cloning Windows</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Displaying-File-and-Buffer-Items">Displaying File and Buffer Items</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Keyboard-Drags">Keyboard Drags</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">

Buttons

</pre></th></tr><tr><td align="left" valign="top">&bull; <a href="#Explicit-Buttons">Explicit Buttons</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Global-Buttons">Global Buttons</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Implicit-Buttons">Implicit Buttons</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Button-Files">Button Files</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Action-Types">Action Types</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Button-Type-Precedence">Button Type Precedence</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Utilizing-Explicit-Buttons">Utilizing Explicit Buttons</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">

Implicit Buttons

</pre></th></tr><tr><td align="left" valign="top">&bull; <a href="#Implicit-Button-Types">Implicit Button Types</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Action-Buttons">Action Buttons</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">

Utilizing Explicit Buttons

</pre></th></tr><tr><td align="left" valign="top">&bull; <a href="#Creation">Creation</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Renaming">Renaming</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Deletion">Deletion</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Modification">Modification</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Searching-and-Summarizing">Searching and Summarizing</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Buttons-in-Mail">Buttons in Mail</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Buttons-in-News">Buttons in News</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">

Creation

</pre></th></tr><tr><td align="left" valign="top">&bull; <a href="#By-Dragging">By Dragging</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Creation Via Action Key Drags
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#By-Menu">By Menu</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Creation Via Menus
</td></tr>
<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">

Koutliner

</pre></th></tr><tr><td align="left" valign="top">&bull; <a href="#Menu-Commands">Menu Commands</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Creating-Outlines">Creating Outlines</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Autonumbering">Autonumbering</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Idstamps">Idstamps</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Editing">Editing</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Viewing">Viewing</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Links">Links</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Cell-Attributes">Cell Attributes</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Koutliner-History">Koutliner History</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">

Editing

</pre></th></tr><tr><td align="left" valign="top">&bull; <a href="#Adding-and-Killing">Adding and Killing</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Relocating-and-Copying">Relocating and Copying</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Moving-Around">Moving Around</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Filling">Filling</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Transposing">Transposing</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Splitting-and-Appending">Splitting and Appending</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Inserting-and-Importing">Inserting and Importing</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Exporting">Exporting</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">

Viewing

</pre></th></tr><tr><td align="left" valign="top">&bull; <a href="#Hiding-and-Showing">Hiding and Showing</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#View-Specs">View Specs</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">

HyRolo

</pre></th></tr><tr><td align="left" valign="top">&bull; <a href="#HyRolo-Concepts">HyRolo Concepts</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#HyRolo-Menu">HyRolo Menu</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#HyRolo-Searching">HyRolo Searching</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#HyRolo-Keys">HyRolo Keys</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#HyRolo-Settings">HyRolo Settings</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">

Developing with Hyperbole

</pre></th></tr><tr><td align="left" valign="top">&bull; <a href="#Hook-Variables">Hook Variables</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Creating-Types">Creating Types</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Explicit-Button-Technicalities">Explicit Button Technicalities</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Encapsulating-Systems">Encapsulating Systems</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Embedding-Hyperbole">Embedding Hyperbole</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">

Creating Types

</pre></th></tr><tr><td align="left" valign="top">&bull; <a href="#Creating-Action-Types">Creating Action Types</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Creating-Implicit-Button-Types">Creating Implicit Button Types</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">

Creating Implicit Button Types

</pre></th></tr><tr><td align="left" valign="top">&bull; <a href="#Action-Button-Link-Types">Action Button Link Types</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Implicit-Button-Link-Types">Implicit Button Link Types</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Programmatic-Implicit-Button-Types">Programmatic Implicit Button Types</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">

Explicit Button Technicalities

</pre></th></tr><tr><td align="left" valign="top">&bull; <a href="#Button-Label-Normalization">Button Label Normalization</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Operational-and-Storage-Formats">Operational and Storage Formats</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Programmatic-Button-Creation">Programmatic Button Creation</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">

Setup

</pre></th></tr><tr><td align="left" valign="top">&bull; <a href="#Installation">Installation</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Invocation">Invocation</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Customization">Customization</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">

Customization

</pre></th></tr><tr><td align="left" valign="top">&bull; <a href="#Referent-Display">Referent Display</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Internal-Viewers">Internal Viewers</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#External-Viewers">External Viewers</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Link-Variable-Substitution">Link Variable Substitution</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Web-Search-Engines">Web Search Engines</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Using-URLs-with-Find_002dFile">Using URLs with Find-File</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Invisible-Text-Searches">Invisible Text Searches</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Button-Colors">Button Colors</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">

Global Key Bindings

</pre></th></tr><tr><td align="left" valign="top">&bull; <a href="#Binding-Minibuffer-Menu-Items">Binding Minibuffer Menu Items</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Default-Global-Bindings">Default Global Bindings</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">

Smart Key Reference

</pre></th></tr><tr><td align="left" valign="top">&bull; <a href="#Smart-Mouse-Keys">Smart Mouse Keys</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Keyboard-Keys">Smart Keyboard Keys</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">

Smart Mouse Keys

</pre></th></tr><tr><td align="left" valign="top">&bull; <a href="#Minibuffer-Menu-Activation">Minibuffer Menu Activation</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Thing-Selection">Thing Selection</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Side_002dby_002dSide-Window-Resizing">Side-by-Side Window Resizing</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Modeline-Clicks-and-Drags">Modeline Clicks and Drags</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Mouse-Drags-between-Windows">Smart Mouse Drags between Windows</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Mouse-Drags-within-a-Window">Smart Mouse Drags within a Window</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Mouse-Drags-outside-a-Window">Smart Mouse Drags outside a Window</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">

Smart Keyboard Keys

</pre></th></tr><tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Company-Mode">Smart Key - Company Mode</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Treemacs">Smart Key - Treemacs</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Dired-Sidebar-Mode">Smart Key - Dired Sidebar Mode</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Emacs-Pushbuttons">Smart Key - Emacs Pushbuttons</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Argument-Completion">Smart Key - Argument Completion</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-ID-Edit-Mode">Smart Key - ID Edit Mode</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Emacs-Cross_002dreferences-_0028Xrefs_0029">Smart Key - Emacs Cross-references (Xrefs)</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Smart-Scrolling">Smart Key - Smart Scrolling</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Smart-Menus">Smart Key - Smart Menus</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Dired-Mode">Smart Key - Dired Mode</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Hyperbole-Buttons">Smart Key - Hyperbole Buttons</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-View-Mode">Smart Key - View Mode</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Helm-Mode">Smart Key - Helm Mode</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Delimited-Things">Smart Key - Delimited Things</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-The-Koutliner">Smart Key - The Koutliner</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-RDB-Mode">Smart Key - RDB Mode</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Help-Buffers">Smart Key - Help Buffers</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Bookmark-Mode">Smart Key - Bookmark Mode</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Pages-Directory-Mode">Smart Key - Pages Directory Mode</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Python-Source-Code">Smart Key - Python Source Code</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Identifier-Menu-Mode">Smart Key - Identifier Menu Mode </a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-C-Source-Code">Smart Key - C Source Code</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-C_002b_002b-Source-Code">Smart Key - C++ Source Code</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Assembly-Source-Code">Smart Key - Assembly Source Code</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Lisp-Source-Code">Smart Key - Lisp Source Code</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Java-Source-Code">Smart Key - Java Source Code</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-JavaScript-Source-Code">Smart Key - JavaScript Source Code</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Objective_002dC-Source-Code">Smart Key - Objective-C Source Code</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Fortran-Source-Code">Smart Key - Fortran Source Code</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Occurrence-Matches">Smart Key - Occurrence Matches</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Calendar-Mode">Smart Key - Calendar Mode</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Man-Page-Apropos">Smart Key - Man Page Apropos</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Emacs-Outline-Mode">Smart Key - Emacs Outline Mode</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Info-Manuals">Smart Key - Info Manuals</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Email-Readers">Smart Key - Email Readers</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-GNUS-Newsreader">Smart Key - GNUS Newsreader</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Buffer-Menus">Smart Key - Buffer Menus</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Tar-File-Mode">Smart Key - Tar File Mode</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Man-Pages">Smart Key - Man Pages</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-WWW-URLs">Smart Key - WWW URLs</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-HyRolo-Match-Buffers">Smart Key - HyRolo Match Buffers</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Image-Thumbnails">Smart Key - Image Thumbnails</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Gomoku-Game">Smart Key - Gomoku Game</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Magit-Mode">Smart Key - Magit Mode</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-The-OO_002dBrowser">Smart Key - The OO-Browser</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Default-Context">Smart Key - Default Context</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><th colspan="3" align="left" valign="top"><pre class="menu-comment">

</pre></th></tr></table>

<hr>
<a name="Introduction"></a>
<div class="header">
<p>
Next: <a href="#Smart-Keys" accesskey="n" rel="next">Smart Keys</a>, Previous: <a href="#Top" accesskey="p" rel="prev">Top</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Introduction-1"></a>
<h2 class="chapter">1 Introduction</h2>

<p>This edition of the GNU Hyperbole Manual is for use with any version
7.1.4 or greater of GNU Hyperbole.  Hyperbole runs atop GNU Emacs 24.3
or higher.  It will trigger an error if your Emacs is older.
</p>
<p>This chapter summarizes the structure of the rest of the manual,
describes Hyperbole, lists some of its potential applications, and
explains how to subscribe to its mail lists.
</p>
<p>Throughout this manual, sequences of keystrokes are delimited by curly
braces <kbd>{ }</kbd>, function and variable names use this <code>typeface</code>.
</p>
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">&bull; <a href="#Manual-Overview" accesskey="1">Manual Overview</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Motivation" accesskey="2">Motivation</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Hyperbole-Overview" accesskey="3">Hyperbole Overview</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Mail-Lists" accesskey="4">Mail Lists</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
</table>

<hr>
<a name="Manual-Overview"></a>
<div class="header">
<p>
Next: <a href="#Motivation" accesskey="n" rel="next">Motivation</a>, Previous: <a href="#Introduction" accesskey="p" rel="prev">Introduction</a>, Up: <a href="#Introduction" accesskey="u" rel="up">Introduction</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Manual-Overview-1"></a>
<h3 class="section">1.1 Manual Overview</h3>

<a name="index-file_002c-DEMO"></a>
<a name="index-Hyperbole-demo"></a>
<a name="index-demo-file"></a>
<a name="index-tutorial"></a>
<p>This is a reference manual with extensive details about Hyperbole use.  If
you prefer a simpler, more interactive introduction to Hyperbole,
the <samp>DEMO</samp> file included in the Hyperbole distribution demonstrates
many of Hyperbole&rsquo;s standard facilities without the need to read through
this reference manual.  The DEMO is a good way to rapidly understand some
of what Hyperbole can do for you.  Once Hyperbole is installed,
(see <a href="#Setup">Setup</a>), you can access the DEMO with the key sequence <kbd>{C-h h
d d}</kbd>.
</p>
<p>See <a href="#Glossary">Glossary</a>, for definitions of Hyperbole terms.  In some cases,
terms are not precisely defined within the body of this manual since they
are defined within the glossary.  Be sure to reference the glossary if a
term is unclear to you.  Although you need not have a keen understanding of
all of these terms, a quick scan of the glossary helps throughout Hyperbole
use.
</p>
<p>See <a href="#Setup">Setup</a>, for explanations of how to obtain, install, configure
and load Hyperbole for use.  This appendix includes information on
user-level settings that you may want to modify after you understand
Hyperbole&rsquo;s basic operation.
</p>
<p>See <a href="#Suggestion-or-Bug-Reporting">Suggestion or Bug Reporting</a>, for instructions on how to ask a
question, suggest a feature or report a bug in Hyperbole.  A few
commonly asked questions are answered in this manual, see <a href="#Questions-and-Answers">Questions and Answers</a>.  If you are interested in classic
articles on hypertext, see <a href="#References">References</a>.
</p>
<p>See <a href="#Smart-Keys">Smart Keys</a>, for an explanation of the innovative, context-sensitive
mouse and keyboard Action and Assist Keys offered by Hyperbole.
See <a href="#Smart-Key-Reference">Smart Key Reference</a>, for a complete reference on what the Action
and Assist Keys do in each particular context that they recognize.
See <a href="#Smart-Key-Argument-Selection">Smart Key Argument Selection</a>, for how Hyperbole speeds selection of
prompted for arguments.
</p>
<p>Keep in mind as you read about using Hyperbole that in many cases, it
provides a number of overlapping interaction methods that support differing
work styles and hardware limitations.  In such instances, you need learn
only one technique that suits you.
</p>
<p>See <a href="#Buttons">Buttons</a>, for an overview of Hyperbole buttons and how to use them.
</p>
<p>See <a href="#Menus">Menus</a>, for summaries of Hyperbole menu commands and how to use
the minibuffer-based menus that work on dumb terminals, PCs or workstations.
</p>
<p>See <a href="#HyControl">HyControl</a>, for how to quickly and interactively control your Emacs
windows and frames and what they display.
</p>
<p>See <a href="#Koutliner">Koutliner</a>, for concept and usage information on the
autonumbered, hypertextual outliner.  See <a href="#Koutliner-Keys">Koutliner Keys</a>, for a full
summary of the outliner commands that are bound to keys.
</p>
<p>See <a href="#HyRolo">HyRolo</a>, for concept and usage information on the
rapid lookup, hierarchical, free text record management system included
with Hyperbole.
</p>
<p>See <a href="#Window-Configurations">Window Configurations</a>, for instructions on how to save and restore
the set of buffers and windows that appear within a frame.  This feature
lets you switch among working contexts easily, even on a dumb terminal.
Such configurations last only throughout a single session of editor
usage.
</p>
<p>See <a href="#Developing-with-Hyperbole">Developing with Hyperbole</a>, if you are a developer who is
comfortable with Lisp.
</p>
<p>See <a href="#Future-Work">Future Work</a>, for future directions in Hyperbole&rsquo;s evolution.
</p>
<hr>
<a name="Motivation"></a>
<div class="header">
<p>
Next: <a href="#Hyperbole-Overview" accesskey="n" rel="next">Hyperbole Overview</a>, Previous: <a href="#Manual-Overview" accesskey="p" rel="prev">Manual Overview</a>, Up: <a href="#Introduction" accesskey="u" rel="up">Introduction</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Motivation-1"></a>
<h3 class="section">1.2 Motivation</h3>

<p>Database vendors apply tremendous resources to help solve corporate
information management problems.  But the information that people deal
with in their everyday worklife is seldom stored away in neatly defined
database schemas.  Instead it is scattered among local and remote files,
e-mail messages, faxes, voice mail and web pages.
</p>
<p>The rise of the web has demonstrated how hypertext technologies can be used
to build massive organized repositories of scattered information.  But
assembling information for the web still remains a great challenge and the
data formats of the web are too structured to deal with the great variety
of information that people process.  Modern web development requires the
use of many languages: HTML, JavaScript, and CSS.  This in itself prevents
its use as the prime means of organizing and interlinking the constant
flows of daily information.
</p>
<p>GNU Hyperbole takes a distinctly different approach.  It has its own
hypertext technology that can interface perfectly with web links but which
are much easier to create (simply drag from the source to the destination
of a link to create a new hyperlink).  Hyperbole hyperbuttons can link not
only to static information but can perform arbitrary actions (through the
use of button types written in a single, highly interactive language, Emacs
Lisp).  Hyperbole adds all of this power to your written documents, e-mail,
news articles, contact management, outlines, directory listings, and much
more.  Hyperbole works well with the very latest versions of GNU Emacs
across every editing and viewing mode in Emacs.
</p>
<p>Unlock the power of GNU Hyperbole to make your information work for you.
One system. One language.  One manual.  One solution.  Learn Hyperbole and
start moving further, faster.
</p>
<hr>
<a name="Hyperbole-Overview"></a>
<div class="header">
<p>
Next: <a href="#Mail-Lists" accesskey="n" rel="next">Mail Lists</a>, Previous: <a href="#Motivation" accesskey="p" rel="prev">Motivation</a>, Up: <a href="#Introduction" accesskey="u" rel="up">Introduction</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Hyperbole-Overview-1"></a>
<h3 class="section">1.3 Hyperbole Overview</h3>

<a name="index-GNU-Hyperbole"></a>
<a name="index-Hyperbole"></a>
<a name="index-hypertext"></a>
<a name="index-Emacs-Lisp"></a>
<a name="index-Emacs"></a>
<p>GNU Hyperbole (pronounced Ga-new Hi-per-bo-lee), or just Hyperbole, is
an efficient, programmable hypertextual information management
system.  It is intended for everyday work on any GNU Emacs platform.
Hyperbole allows hypertext buttons to be embedded within unstructured
and structured files, mail messages and news articles.  It offers
intuitive mouse-based control of information display within multiple
windows.  It also provides point-and-click access to Info manuals, ftp
archives, and the World-Wide Web (WWW).
</p>
<p>Hyperbole consists of five parts:
</p>
<dl compact="compact">
<dt><em>Buttons and Smart Keys</em></dt>
<dd><p>Hyperbole hyperlink and other kinds of buttons (explicit buttons) may be
added to documents with a simple drag between windows, no markup language
needed.  Implicit buttons are patterns automatically recognized within
existing text that perform actions, e.g. bug#24568 displays the bug status
information for that Emacs bug number, without the need for any additional
markup.  Global buttons are buttons that are activated by name from
anywhere within Emacs.
See <a href="#Buttons">Buttons</a>.
</p>
<p>Buttons are accessed by clicking on them or referenced by name (global
buttons), so they can be activated regardless of what is on screen.
Users create and activate Hyperbole buttons; Emacs Lisp programmers
easily can develop new button types and actions.
</p>
<p>Hyperbole includes two special <em>Smart Keys</em>, the Action Key and
the Assist Key, that perform an extensive array of context-sensitive
operations across emacs usage, including activating and showing help
for Hyperbole buttons.  In many popular Emacs modes, they allow you to
perform common, sometimes complex operations without having to use a
different key for each operation.  Just press a Smart Key and the
right thing happens.  See <a href="#Smart-Keys">Smart Keys</a>;
</p>
</dd>
<dt><em>Contact and Text Finder</em></dt>
<dd><p>an interactive, textual information management interface, including
fast, flexible file and text finding commands.  A powerful, hierarchical
contact manager, see <a href="#HyRolo">HyRolo</a>, which anyone can use, is also included.
It is easy to learn since it introduces only a few new mechanisms
and has a menu interface, which may be operated from the keyboard or the
mouse; it may also be used to look up any record-based information and
Hyperbole buttons may be embedded in any records;
</p>
</dd>
<dt><em>Screen Control</em></dt>
<dd><p>the fastest, easiest-to-use window and frame control available for GNU
Emacs, see <a href="#HyControl">HyControl</a>.  With just a few keystrokes, you can shift from
increasing a window&rsquo;s height by 5 lines to moving a frame by 220 pixels
or immediately moving it to a screen corner.  Text in each window or
frame may be enlarged or shrunk (zoomed) for easy viewing, plus many
other features; this allows Hyperbole to quickly control the way
information is presented on-screen;
</p>
</dd>
<dt><em>Hypertextual Outliner</em></dt>
<dd><p>an advanced outliner, see <a href="#Koutliner">Koutliner</a>, with multi-level
autonumbering and permanent identifiers attached to each outline node
for use as hypertext link anchors, per node properties and flexible
view specifications that can be included in links or used
interactively;
</p>
</dd>
<dt><em>Programming Library</em></dt>
<dd><p>a set of programming libraries, see <a href="#Developing-with-Hyperbole">Developing with Hyperbole</a>, for
system developers who want to integrate Hyperbole with another user
interface or as a back-end to a distinct system.  (All of Hyperbole is
written in Emacs Lisp for ease of modification.  It has been engineered
for real-world usage and is well structured).
</p></dd>
</dl>

<a name="index-C_002dh-h-d-d"></a>
<a name="index-file_002c-DEMO-1"></a>
<a name="index-demonstration"></a>
<a name="index-button-demo"></a>
<p>Hyperbole may be used simply for browsing through documents
pre-configured with Hyperbole buttons, in which case, you can safely
ignore most of the information in this manual.  Jump right into the
Hyperbole demonstration by typing <kbd>{C-h h d d}</kbd>, assuming Hyperbole
has been installed at your site.  If you need to install
Hyperbole, see <a href="#Setup">Setup</a>, for Hyperbole installation and configuration
information.  The demo offers a much less technical introduction to
Hyperbole by supplying good examples of use.
</p>
<div class="float"><a name="image_003aDemo"></a>

<img src="im/demo.png" alt="Hyperbole Minibuffer Menu and Demonstration Screenshot">
<div class="float-caption"><p><strong>Image 1.1: </strong>Hyperbole Minibuffer Menu and Demonstration Screenshot</p></div></div><br>

<a name="index-GNU-Emacs"></a>
<a name="index-C_002dh-t"></a>
<p>You likely will want to do more than browse with Hyperbole,
e.g. create your own buttons.  The standard Hyperbole button editing
user interface is Emacs-based, so a basic familiarity with the Emacs
editing model is useful.  The material covered in the Emacs
tutorial, normally bound to <kbd>{C-h t}</kbd>, is more than
sufficient as background.  See <a href="http://www.gnu.org/software/emacs/manual/html_mono/emacs.html#Glossary">Glossary</a> in <cite>the GNU Emacs Manual</cite>,
if some emacs-related terms are unfamiliar to you.
</p>
<a name="index-Hyperbole-features"></a>
<p>A Hyperbole user works with chunks of information that need to be
organized, interlinked, and processed.  Such chunks can be hyperbuttons,
address book contacts, items in an outline, or even database query
results.  Hyperbole does not enforce any particular hypertext or
information management model, but instead allows you to organize your
information in large or small chunks as you see fit.  The Hyperbole
outliner organizes information into hierarchies which may also contain
links to external information sources.  See <a href="#Koutliner">Koutliner</a>.
</p>
<p>Some of Hyperbole&rsquo;s most significant features are:
</p>
<ul>
<li> Buttons may link to information or may execute functions, such as
starting or communicating with external programs;

</li><li> A simple mouse drag from a button source location to its link
destination is often all that is needed to create a new link.
The keyboard can also be used to emulate such drags;

</li><li> Buttons may be embedded within electronic mail messages;

</li><li> Outlines allow rapid browsing, editing and movement of chunks of
information organized into trees (hierarchies);

</li><li> Other hypertext and information retrieval systems may be encapsulated
under a Hyperbole user interface (a number of samples are provided).
</li></ul>

<a name="index-Hyperbole-applications"></a>
<p>Typical Hyperbole applications include:
</p>
<dl compact="compact">
<dt><em>personal information management</em></dt>
<dd><p>Hyperlinks provide a variety of views into an information space.  A
search facility locates hyperbuttons in context and permits quick
selection.
</p>
</dd>
<dt><em>documentation and code browsing</em></dt>
<dd><p>Cross-references may be embedded within documentation and code.  Existing
documentation may be augmented with point-and-click interfaces to link
code with associated design documents, or to permit direct access to the
definition of identifiers by selecting their names within code or
other documents.
</p>
</dd>
<dt><em>brainstorming</em></dt>
<dd><p>The Hyperbole outliner (see <a href="#Koutliner">Koutliner</a>) is an effective tool for
capturing ideas and then quickly reorganizing them in a meaningful way.
Links to related ideas are easy to create so the need to copy and
paste information is greatly reduced.
</p>
</dd>
<dt><em>help/training systems</em></dt>
<dd><p>Tutorials with buttons can show students how things work while
explaining the concepts, e.g. an introduction to the commands available
on a computer system.  This technique can be much more effective than
written documentation alone.
</p>
</dd>
<dt><em>archive managers</em></dt>
<dd><p>Programs that manage archives from incoming information streams may be
supplemented by having them add topic-based buttons that link to the
archive holdings.  Users can then search and create their own links to
archive entries.
</p></dd>
</dl>

<hr>
<a name="Mail-Lists"></a>
<div class="header">
<p>
Previous: <a href="#Hyperbole-Overview" accesskey="p" rel="prev">Hyperbole Overview</a>, Up: <a href="#Introduction" accesskey="u" rel="up">Introduction</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Mail-Lists-1"></a>
<h3 class="section">1.4 Mail Lists</h3>

<p>If you use Hyperbole, you may join the mailing list
&lt;hyperbole-users@gnu.org&gt; to discuss Hyperbole with users and maintainers.
There is a separate mail list to report problems or bugs with
Hyperbole, &lt;bug-hyperbole@gnu.org&gt;.  For more details,
see <a href="#Suggestion-or-Bug-Reporting">Suggestion or Bug Reporting</a>.
</p>
<hr>
<a name="Smart-Keys"></a>
<div class="header">
<p>
Next: <a href="#Buttons" accesskey="n" rel="next">Buttons</a>, Previous: <a href="#Introduction" accesskey="p" rel="prev">Introduction</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Smart-Keys-1"></a>
<h2 class="chapter">2 Smart Keys</h2>

<a name="index-Smart-Key"></a>
<a name="index-mouse-support"></a>
<a name="index-Action-Key"></a>
<a name="index-Assist-Key"></a>
<a name="index-middle-mouse-key"></a>
<a name="index-hmouse_002dmiddle_002dflag"></a>
<a name="index-Action-Key-1"></a>
<a name="index-Assist-Key-1"></a>
<p>Hyperbole offers two special <em>Smart Keys</em>, the Action Key and the
Assist Key, that perform an extensive array of context-sensitive
operations across emacs usage.  In many popular modes, they allow you
to perform common, sometimes complex operations without having to use a
different key for each operation.  Just press a Smart Key and the
right thing happens.  This chapter explains typical uses of the Smart
Keys.  See <a href="#Smart-Key-Reference">Smart Key Reference</a>, for complete descriptions of their
behavior in all contexts.
</p>
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-Bindings" accesskey="1">Smart Key Bindings</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-Operations" accesskey="2">Smart Key Operations</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-Argument-Selection" accesskey="3">Smart Key Argument Selection</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-Debugging" accesskey="4">Smart Key Debugging</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-Thing-Selection" accesskey="5">Smart Key Thing Selection</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Mouse-Key-Modeline-Clicks" accesskey="6">Smart Mouse Key Modeline Clicks</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Mouse-Key-Drags" accesskey="7">Smart Mouse Key Drags</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
</table>

<hr>
<a name="Smart-Key-Bindings"></a>
<div class="header">
<p>
Next: <a href="#Smart-Key-Operations" accesskey="n" rel="next">Smart Key Operations</a>, Previous: <a href="#Smart-Keys" accesskey="p" rel="prev">Smart Keys</a>, Up: <a href="#Smart-Keys" accesskey="u" rel="up">Smart Keys</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Smart-Key-Bindings-1"></a>
<h3 class="section">2.1 Smart Key Bindings</h3>

<a name="index-C_002du-M_002dRET"></a>
<a name="index-M_002dRET"></a>
<p>From the keyboard, <kbd>{M-<span class="key">RET</span>}</kbd> is the Action Key and <kbd>{C-u
M-<span class="key">RET</span>}</kbd> is the Assist Key.  These keys allow context-sensitive
operation from any keyboard.
</p>

<a name="index-shift_002dmiddle-mouse-key"></a>
<a name="index-shift_002dleft-mouse-key"></a>
<a name="index-shift_002dright-mouse-key"></a>
<a name="index-middle-mouse-key-1"></a>
<a name="index-hmouse_002dmiddle_002dflag-1"></a>
<p>From the mouse, the <em>Action Key</em> is bound to your shift-middle
mouse key (or shift-left on a 2-button mouse).  The <em>Assist Key</em>
is bound to your shift-right mouse key, assuming Hyperbole is run
under an external window system.
</p>
<a name="index-hmouse_002dadd_002dunshifted_002dsmart_002dkeys"></a>
<a name="index-unshifted-mouse-bindings"></a>
<a name="index-unshifted-mouse-keys"></a>
<a name="index-mouse-keys_002c-unshifted"></a>
<a name="index-smart-keys_002c-unshifted"></a>
<p>If you set the variable, <code>hmouse-middle-flag</code>, to &lsquo;<samp>t</samp>&rsquo; before
loading Hyperbole, then you may also use the middle mouse key as the Action
Key).  If you want both the middle mouse key as the Action Key and the
right mouse key as the Assist Key for ease of use, then within your
personal <samp>~/.emacs</samp> file, add: <code>(add-hook 'hyperbole-init-hook
'hmouse-add-unshifted-smart-keys)</code> and then restart Emacs.
</p>
<a name="index-key-binding_002c-smart-keys"></a>
<a name="index-smart-key-commands"></a>
<a name="index-smart-key-assignments"></a>
<a name="index-action_002dkey"></a>
<a name="index-assist_002dkey"></a>
<a name="index-action_002dmouse_002dkey"></a>
<a name="index-assist_002dmouse_002dkey"></a>
<a name="index-hkey_002deither"></a>
<p>If you prefer other key assignments, simply bind the commands
<code>action-key</code> and <code>assist-key</code> to keyboard keys.
Hyperbole binds <kbd>{M-<span class="key">RET</span>}</kbd> to the command <code>hkey-either</code>.
It allows for a single key binding for both commands; a prefix
argument, such as <kbd>{C-u}</kbd>, then invokes <code>assist-key</code>.
</p>
<p>You may also bind <code>action-mouse-key</code> and <code>assist-mouse-key</code>
to other mouse keys, though you won&rsquo;t be able to execute mouse drag
actions with such key bindings.
</p>
<p>Mouse configuration of the Smart Keys is automatic for GNU Emacs under
Mac OS X, the X Window System and MS Windows assuming your emacs program
has been built with support for any of these window systems.
</p>
<a name="index-file_002c-_002eemacs"></a>
<a name="index-hyperbole_002dtoggle_002dbindings"></a>
<a name="index-change-key-bindings"></a>
<a name="index-toggle-key-bindings"></a>
<a name="index-key-bindings_002c-toggle"></a>
<a name="index-disable-Hyperbole"></a>
<a name="index-C_002dc-h"></a>
<p>If you ever need to temporarily disable the Hyperbole keyboard and mouse
bindings, use the <code>hyperbole-toggle-bindings</code> command.  It switches
between the Hyperbole key bindings and those set prior to loading Hyperbole
and then back again if invoked once more.  There is no default key binding
for this command; use <kbd>{M-x hyperbole-toggle-bindings
<span class="key">RET</span>}</kbd>.  Alternatively, you may select a key and bind it as part of any
setting of <code>hyperbole-init-hook</code> within your personal <samp>~/.emacs</samp>
file.  For example, <code>(add-hook 'hyperbole-init-hook (lambda ()
(global-set-key &quot;\C-ch&quot; 'hyperbole-toggle-bindings)))</code>.
</p>

<hr>
<a name="Smart-Key-Operations"></a>
<div class="header">
<p>
Next: <a href="#Smart-Key-Argument-Selection" accesskey="n" rel="next">Smart Key Argument Selection</a>, Previous: <a href="#Smart-Key-Bindings" accesskey="p" rel="prev">Smart Key Bindings</a>, Up: <a href="#Smart-Keys" accesskey="u" rel="up">Smart Keys</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Smart-Key-Operations-1"></a>
<h3 class="section">2.2 Smart Key Operations</h3>

<a name="index-button-activation"></a>
<a name="index-activation"></a>
<a name="index-button-help"></a>
<a name="index-help_002c-button"></a>
<p>The Action Key generally selects entities, creates links and
activates buttons.  The Assist Key generally provides help,
such as reporting on a button&rsquo;s attributes, or serves a complementary
function to whatever the Action Key does within a context.
</p>
<a name="index-Smart-Key-operation"></a>
<a name="index-menu-item_002c-Doc_002fSmartKeys"></a>
<a name="index-Smart-Key-summary"></a>
<a name="index-modeline_002c-Smart-Keys"></a>
<p>The Hyperbole Doc/SmartKeys menu entry, <kbd>{C-h h d s}</kbd>, displays a
summary of what the Smart Keys do in all of their different contexts.
Alternatively, a click of the Assist Mouse Key in the right corner of a
window modeline (within the rightmost 3 characters) toggles between
displaying this summary and hiding it.  Reference this summary whenever you
need it.
</p>
<p>The following table is the same summary.  Much of the browsing power
of Hyperbole comes from the use of the Smart Keys, so spend some time
practicing how to use them.  Study what modeline clicks and window
drag actions do as these will give you a lot of power without much
effort.  This table may appear daunting at first, but as you practice
and notice that the Smart Keys do just a few context-sensitive things
per editor mode, you will find it easy to just press or point and
click and let Hyperbole do the right thing in each context.
</p>

<div class="format">
<div class="example">
<pre class="example">========================================================================================
                                              Smart Keys
Context                         Action Key                 Assist Key
========================================================================================
Hyperbole
  On a minibuffer menu item     Activates item             Item help
  On an explicit button         Activates button           Button help
  Reading argument
    1st press at an arg value   Value copied to minibuffer &lt;- same
    2nd press at an arg value   Value used as argument     &lt;- same
    In minibuffer               Accepts minibuffer arg     Completion help
  On an implicit button/path    Activates button           Button help
  Within a koutline cell        Collapses and expands      Shows tree props
  Left of a koutline cell       Creates a klink            Moves a tree
  HyRolo Match Buffer           Edits entries and mails to e-mail addresses

Mouse or Keyboard Display Control
  Line end, not end of buffer
    smart-scroll-proportional
      = t   (default)           Makes curr line top line   Bottom line
      = nil                     Scrolls up a windowful     Scrolls down
  End of Any Help buffer        Restores screen to the previous state
  Read-only View Mode           Scrolls up a windowful     Scrolls wind down

Mouse-only Control
  Drag from thing start or end  Yanks thing at release     Kills thing and yanks
    A thing is a delimited                                 at release
    expression, such as a
    string, list or markup
    language tag pair

  Drag from bottom Modeline     Reposition frame as        &lt;- same
  in frame with non-nil         drag happens
  drag-with-mode-line param

  Drag from shared window side
    or from left of scroll bar  Resizes window width       &lt;- same
  Modeline vertical drag        Resizes window height      &lt;- same

  Other Modeline drag to        Replaces dest. buffer      Swaps window buffers
    another window                with source buffer

  Drag to a Modeline from:
    buffer/file menu item       Displays buffer/file in    Swaps window buffers
                                  new window by release
    buffer/file menu 1st line   Moves buffer/file menu to  Swaps window buffers
                                  new window by release
    anywhere else               Displays buffer in         Swaps window buffers
                                  new window by release

  Drag between windows from:
    buffer/file menu item       Displays buffer/file in    Swaps window buffers
                                  window of button release 
    buffer/file menu 1st line   Moves buffer/file menu     Swaps window buffers
    anywhere else               Creates/modifies a link    Swaps window buffers

  Drag outside of Emacs from:
    buffer/file menu item       Displays buffer/file in    Moves window to new frame
                                  a new frame
    Modeline or other window    Clones window to new frame Moves window to new frame

  Modeline Click
    Left modeline edge          Buries current buffer      Unburies bottom buffer
    Right modeline edge         Info manual browser        Smart Key summary
    Buffer ID                   Dired on buffer's dir      Next buffer
                                  or on parent when a dir
    Other blank area            Action Key modeline hook   Assist Key modeline hook
                                  Shows/Hides Buffer Menu    Popup Jump &amp; Manage Menu

  Drag in window, region active Error, not allowed         Error, not allowed
  Horizontal drag in a window   Splits window below        Deletes window
  Vertical drag in a window     Splits window side-by-side Deletes window
  Diagonal drag in a window     Saves wconfig              Restores wconfig from ring

  Active region exists, click   Yanks region at release    Kills and yanks at release
   outside of the region

Hyperbole Key Press/Click in Special Modes
  Region Active                 Yanks region at release    Kills and yanks at release
  Company Mode Completion       Displays definition        Displays documentation
  Helm Completion               Displays item              Displays item
  Treemacs                      Displays item              Displays item
  Dired Sidebar                 Displays item              Displays item
  Emacs Push Button             Activates button           Button help
  Thing Begin or End            Mark thing region          Mark &amp; kill thing region
  Page Directory Listing        Jumps to page              &lt;- same
  Imenu Programming Identifier  Jumps to in-buffer def     Prompts for id to jump to
  C,C++,Objective-C,Java Modes  Jumps to id/include def    Jumps to next def
  Assembly Language Mode        Jumps to id/include def    Jumps to next def
  Java Cross-reference Tag      Jumps to identifier def    Jumps to next def
  JavaScript and Python Modes   Jumps to identifier def    Jumps to next def
  Any Known Lisp or ChangeLog   Jumps to identifier def    Referent Doc
  Fortran Mode                  Jumps to identifier def    Jumps to next def
  Emacs Lisp Compiler Error     Jumps to def with error    &lt;- same
  Other Compiler Error          Jumps to src error line    &lt;- same
  Grep or Occur Match           Jumps to match source line &lt;- same
  Multi-buffer Occur Match      Jumps to match source line &lt;- same
  Etags `TAGS' file entry       Jumps to source line       Button help
  Ctags file entry              Jumps to source line       Button help
  Texinfo Cross-reference
    Before opening brace        Jumps to Texinfo referent  Button help
    Within braces               Jumps to Info referent     Button help
    Menu Item or node hdr       Jumps to Texinfo referent  Button help
    Include file                Jumps to Texinfo referent  Button help
    code/var reference          Displays doc for referent  Button help
  Org Mode                      Follows links and cycles outline views
  Magit Modes                   Collapses, expands and jumps to things
  Outline Major/Minor Modes     Collapses, expands, and moves outline entries
  Man Apropos                   Displays man page entry    &lt;- same
  Man Pages                     Follows cross refs, file refs and C code refs
  I/Buffer Menu                 Saves, deletes and displays buffers

Emacs Info Reader
  Menu Entry or Cross Ref       To referent                &lt;- same
  Up, Next or Prev Header       To referent                To prior node
  File entry of Header          To top node                To (DIR) node
  End of current node           To next node               To previous node
  Anywhere else                 Scrolls up a windowful     Scrolls wind down

Subsystems
  Calendar                      Scrolls or shows appts     Scrolls/marks date
  GNU Debbugs Tracker           Displays issue discussion  Displays issue status
  Dired Mode                    Views and deletes files from dir listing
  GNUS News Reader              Toggles group subscriptions, gets new news,
                                  and browses articles
  Mail Reader and Summaries     Browses, deletes and expunges messages
  OO-Browser                    Browses object classes and elements
  Tar Mode                      Views and edits files from tar archive files

Any other context (defaults)    Invalid context error      Invalid context error
========================================================================================
</pre></div>
</div>

<p>See <a href="#Smart-Key-Reference">Smart Key Reference</a>, for extensive reference documentation on the
Smart Keys.
</p>
<a name="index-action_002dkey_002ddefault_002dfunction"></a>
<a name="index-assist_002dkey_002ddefault_002dfunction"></a>
<a name="index-Smart-Key_002c-default-context"></a>
<a name="index-default-Smart-Key-context"></a>
<p>Note how the last line in the table explains that the default behavior of
the Smart Keys in an unknown context is to report an error.  You can change
these behaviors by setting two variables.  See the documentation
for the variables <code>action-key-default-function</code> and
<code>assist-key-default-function</code> for information on how to customize
the behavior of the Smart Keys within default contexts.
</p>
<a name="index-Smart-Key-help"></a>
<a name="index-help_002c-Smart-Key"></a>
<a name="index-context_002dsensitive-help"></a>
<p>When you use a mouse and you want to find out what either of the Smart
Keys does within a context, depress the one you want to check on and
hold it down, then press the other and release as you please.  A help
buffer will pop up explaining the actions that will be performed in that
context, if any.  A press of either Smart Key at the end of that
help buffer will restore your display to its configuration prior to
invoking help.
</p>
<a name="index-C_002dh-A"></a>
<a name="index-C_002du-C_002dh-A"></a>
<p>On the keyboard, <kbd>{C-h A}</kbd> displays this same context-sensitive
help for the Action Key while <kbd>{C-u C-h A}</kbd> displays the help for
the Assist Key.  Note that <kbd>{C-h a}</kbd> performs a function unrelated
to Hyperbole, so you must press the shift key when you type
the <tt class="key">A</tt> character.
</p>
<hr>
<a name="Smart-Key-Argument-Selection"></a>
<div class="header">
<p>
Next: <a href="#Smart-Key-Debugging" accesskey="n" rel="next">Smart Key Debugging</a>, Previous: <a href="#Smart-Key-Operations" accesskey="p" rel="prev">Smart Key Operations</a>, Up: <a href="#Smart-Keys" accesskey="u" rel="up">Smart Keys</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Smart-Key-Argument-Selection-1"></a>
<h3 class="section">2.3 Smart Key Argument Selection</h3>

<a name="index-Hyperbole-help"></a>
<p>A prime design criterion of Hyperbole&rsquo;s user interface is that you
should be able to see what an operation will do before using it.  The
Assist Key typically shows you what a button or minibuffer menu item
will do before you activate it.  Hyperbole also displays the result of
directly selecting an argument value with the Action Key, to provide
feedback as to whether the correct item has been selected.  A second
press/click is necessary before an argument is accepted and processed.
</p>
<a name="index-argument-entry"></a>
<a name="index-direct-selection"></a>
<a name="index-double-click"></a>
<p>Many Hyperbole commands prompt you for arguments.  The standard
Hyperbole user interface has an extensive core of argument types that
it recognizes.  Whenever Hyperbole is prompting you for an argument,
it knows the type that it needs and provides some error checking to
help you get it right.  More importantly, it allows you to press the
Action Key within an entity that you want to use as an argument and it
will grab the appropriate thing and show it to you at the input prompt
within the minibuffer.  If you press (click with a mouse) the Action
Key on the same thing again, it accepts the entity as the argument
and moves on.  Thus, a double click registers a desired argument.
Double-quoted strings, pathnames, mail messages, Info nodes, dired
listings, buffers, numbers, completion items and so forth are all
recognized at appropriate times.  All of the argument types mentioned
in the documentation for the Emacs Lisp <code>interactive</code> function
are recognized.  Experiment a little and you will quickly get used to
this direct selection technique.
</p>
<a name="index-completion"></a>
<p>Wherever possible, standard Emacs completion is offered, as described in
<a href="http://www.gnu.org/software/emacs/manual/html_mono/emacs.html#Completion">Completion</a> in <cite>the GNU Emacs Manual</cite>.  Remember to use <kbd>{?}</kbd>
to see what your possibilities for an argument are.  Once you have a
list of possible completions on screen, press the Action Key twice on
any item to enter it as the argument.
</p>
<hr>
<a name="Smart-Key-Debugging"></a>
<div class="header">
<p>
Next: <a href="#Smart-Key-Thing-Selection" accesskey="n" rel="next">Smart Key Thing Selection</a>, Previous: <a href="#Smart-Key-Argument-Selection" accesskey="p" rel="prev">Smart Key Argument Selection</a>, Up: <a href="#Smart-Keys" accesskey="u" rel="up">Smart Keys</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Smart-Key-Debugging-1"></a>
<h3 class="section">2.4 Smart Key Debugging</h3>

<p>Typically, <kbd>{C-h A}</kbd> and <kbd>{C-u C-h A}</kbd> which show Action and
Assist Key help for the current context, are sufficient for seeing how
the Smart Keys behave no matter where they are used.
</p>
<a name="index-C_002dh-h-c-d"></a>
<a name="index-Smart-Key-debugging"></a>
<a name="index-menu-item_002c-Cust_002fDebug_002dToggle"></a>
<a name="index-debugging-Smart-Keys"></a>
<a name="index-troubleshooting-Smart-Keys"></a>
<a name="index-Messages-buffer"></a>
<a name="index-logging-Smart-Key-behavior"></a>
<p>However, if a Smart Key ever behaves differently than you think it
should or if you want to test how the Smart Keys respond in a new
context, then the Smart Key debugging flag may be of use.  You toggle
it on and off with <kbd>{C-h h c d}</kbd> (minibuffer menu
Cust/Debug-Toggle).  Once enabled, this displays a message in the
minibuffer each time the Action or Assist Key is released, showing
the context of the press and its associated action, so you can see
exactly what is happening whenever you use a Smart Key.  These
messages are all prefaced with &ldquo;(HyDebug)&rdquo; and logged to the
&ldquo;*Messages*&rdquo; buffer for later viewing.
</p>
<a name="index-C_002dh-h-m-c"></a>
<a name="index-C_002dh-h-m-r"></a>
<p>If you do find a problem with the Smart Keys and want to report a bug,
use <kbd>{C-h h m r}</kbd> to compose an email message to the bug-hyperbole
list.  Hyperbole will automatically include all of the &ldquo;(HyDebug)&rdquo;
messages from your current emacs session into your email.  Similarly,
when you compose an email to the hyperbole-users mailing list
with <kbd>{C-h h m c}</kbd>, these messages are also included.
</p>
<hr>
<a name="Smart-Key-Thing-Selection"></a>
<div class="header">
<p>
Next: <a href="#Smart-Mouse-Key-Modeline-Clicks" accesskey="n" rel="next">Smart Mouse Key Modeline Clicks</a>, Previous: <a href="#Smart-Key-Debugging" accesskey="p" rel="prev">Smart Key Debugging</a>, Up: <a href="#Smart-Keys" accesskey="u" rel="up">Smart Keys</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Smart-Key-Thing-Selection-1"></a>
<h3 class="section">2.5 Smart Key Thing Selection</h3>

<a name="index-sexp-selection"></a>
<a name="index-code-block-selection"></a>
<a name="index-selection"></a>
<a name="index-smart-selection"></a>
<a name="index-smart-marking"></a>
<a name="index-region-selection"></a>
<a name="index-things"></a>
<a name="index-delimited-things"></a>
<p>Hyperbole has some radically cool ways to select regions of structured text
or source code and to copy or move them between buffers with a single mouse
drag or two key presses.  A great deal of smarts are built-in so that it
does the right thing most of the time; many other attempts at similar
behavior such as <samp>thing.el</samp> fail to deal with many file format
complexities.
</p>
<p>We use the term <em>things</em> to refer to structured entities that
Hyperbole can select.  These include: delimited pairs of (), {}, &lt;&gt;,
[] and quote marks, source code functions, source code comments and
matching tag pairs in HTML and SGML modes.  <em>Delimited things</em> are
those things that contain a selectable delimiter such as an opening
parenthesis.
</p>
<a name="index-HTML-tag-pair"></a>
<a name="index-SGML-tag-pair"></a>
<a name="index-XML-tag-pair"></a>
<p>The best way to mark a delimited thing is to move your cursor to the
starting delimiter of the thing and then press the Action Key.
Typically, you will see the thing highlight.  You can then operate
upon it as you would any Emacs region.  In many cases, you can do the
same thing upon the closing delimiter, but this is not as reliable.
An Action Key press on the start of an HTML, XML, or SGML tag pair
marks the entire region span of the pair.  If you use the Assist Key
instead, it will mark and kill (delete) the thing.
</p>
<a name="index-drag_002c-with-region"></a>
<a name="index-kill-region"></a>
<a name="index-yank-region"></a>
<a name="index-cut-region"></a>
<a name="index-copy-region"></a>
<a name="index-paste-region"></a>
<p>Even better are Smart Mouse Key thing drags which let you copy or move
delimited things in one operation without having to select a region.  To
copy, simply drag with the Action Key from a thing&rsquo;s opening delimiter
and release somewhere outside of the thing, either within the same
window or within another window.  The thing will be copied to the
point of release.  If you want to move a thing, simply perform the
same drag but with the Assist Mouse Key.  Ensure that you do not move
any explicit buttons from one buffer to another as that does not
work.
</p>
<p>Hyperbole also binds two convenience keys for working with things.
</p>
<a name="index-C_002dc-RET"></a>
<a name="index-hui_002dselect_002dthing"></a>
<a name="index-hui_002dselect_002dthing_002dwith_002dmouse"></a>
<p>The first such key is <kbd>{C-c <span class="key">RET</span>}</kbd> <code>hui-select-thing</code> which
selects bigger and bigger syntactic regions with each successive use.
Double or triple clicks of the Selection Key (left mouse key) do the same
thing.  The first press selects a region based upon the character at point.
For example, with point over an opening or closing grouping character, such
as { or }, the whole grouping is selected, e.g. a C function.  When on an
_ or - within a programming language identifier name, the whole name is
selected.  The type of selection is displayed in the minibuffer as
feedback.  When using a language in which indentation determines nesting
level like Python, a double click on the first alpha character of a line,
such as an if statement, selects the current clause (until the next line at
the same or lesser indentation).  Use <kbd>{C-g}</kbd> to unmark the region when
done.  Use, <code>hui-select-thing-with-mouse</code> if you want to bind this to
a different mouse key to use single clicks instead of double clicks.
</p>
<a name="index-C_002dc-_002e"></a>
<a name="index-hui_002dselect_002dgoto_002dmatching_002dtag"></a>
<p>The second convenience key is bound in HTML/XML/SGML/web
modes.  <kbd>{C-c .}</kbd> <code>hui-select-goto-matching-tag</code> jumps between
the opening and closing tag of a pair.  It moves point to the start of
the tag paired with the closest tag that point is within or which it
precedes.  A second press moves point to the matching tag of the pair,
allowing you to quickly jump back and forth between opening and
closing tags.
</p>
<hr>
<a name="Smart-Mouse-Key-Modeline-Clicks"></a>
<div class="header">
<p>
Next: <a href="#Smart-Mouse-Key-Drags" accesskey="n" rel="next">Smart Mouse Key Drags</a>, Previous: <a href="#Smart-Key-Thing-Selection" accesskey="p" rel="prev">Smart Key Thing Selection</a>, Up: <a href="#Smart-Keys" accesskey="u" rel="up">Smart Keys</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Smart-Mouse-Key-Modeline-Clicks-1"></a>
<h3 class="section">2.6 Smart Mouse Key Modeline Clicks</h3>

<p>Smart Mouse Key clicks on a window&rsquo;s modeline offer many powerful browsing
features, including directory editing (dired), user manual browsing, and
window, buffer and frame selection.  Generally, only Hyperbole-specific
modeline actions are discussed herein.
</p>
<ul>
<li> Leftmost Character

<a name="index-bury-buffer"></a>
<a name="index-unbury-buffer"></a>
<a name="index-modeline_002c-bury-buffer"></a>
<a name="index-modeline_002c-unbury-buffer"></a>
<a name="index-modeline_002c-leftmost-character"></a>
<p>Action Key clicks on the first (usually blank) character of the
modeline bury the current buffer in the buffer list and display the
next buffer in the list.  Assist Key clicks do the reverse and unbury
the bottom buffer.
</p>
<a name="index-modeline_002c-next-buffer"></a>
<a name="index-modeline_002c-prev-buffer"></a>
<p>A similar effect can be achieved with the standard Emacs mouse 1 (left) and
3 (right) buttons on the Buffer ID element of modeline to cycle through
previous and next buffers, respectively.  This may be easier to use since
you can click anywhere on the buffer identifier.
</p>
</li><li> Buffer ID Element

<a name="index-dired"></a>
<a name="index-directory-editor"></a>
<a name="index-dired_002djump"></a>
<a name="index-modeline_002c-dired"></a>
<a name="index-buffer-id"></a>
<a name="index-modeline_002c-buffer-id"></a>
<a name="index-dragging-items_002c-dired"></a>
<p>On the left part of the modeline is the buffer identification,
generally the name of the buffer in use.  An Action Key click on that
switches the window to edit the buffer&rsquo;s directory using dired.
Then Action Key clicks on directory items in the dired buffer display the
items selected in other windows.  An Action Key drag from an item to
another window displays the item in that window.
</p>
<p>An Action Key click on the first line in a dired buffer which contains
the current directory path, specifically on any ancestor part of the
path (the part to the left of the click point), starts another dired
session on the ancestor directory.  Click at the end of this line or
on the last line to end the dired session (bury its buffer).
</p>
<a name="index-Treemacs"></a>
<a name="index-file-viewer_002c-Treemacs"></a>
<p>If you use the Treemacs file viewer Emacs package, you can configure Hyperbole
to use this instead of Dired when you click on a modeline buffer id.
</p>
<p>Since this is a customization option, it may be changed permanently like so.
Use <kbd>{M-x customize-set-variable <span class="key">RET</span> action-key-modeline-buffer-id-function <span class="key">RET</span>}</kbd>.
Change the value to <code>smart-treemacs-modeline</code>.  Then press <tt class="key">RET</tt>.  To change it back
to Hyperbole&rsquo;s default, use the value, <code>dired-jump</code>.
</p>
</li><li> Large Blank Area

<a name="index-buffer-menu"></a>
<a name="index-modeline_002c-buffer-menu"></a>
<a name="index-jump-menu"></a>
<a name="index-modeline_002c-jump-menu"></a>
<a name="index-dragging-items_002c-buffer-menu"></a>
<p>An Action Mouse Key click in a blank area of a window modeline (away
from left and right edges) toggles between displaying and hiding a
list of all buffers.  Once displayed, an Action Key click on a buffer
item will display it in another window.  You can drag items to specific
windows for display as well.
</p>
<p>Alternatively, you may (1) display the buffer menu, (2) use its <kbd>{m}</kbd>
command to mark buffers, and (3) use the Hyperbole <kbd>{@}</kbd> command to
display the marked buffers in a grid of popup windows whose number of
rows and columns you specify at the prompt or via a prefix argument.
This also works in <code>ibuffer-menu</code> and <code>dired</code> modes.
See <a href="#HyControl">HyControl</a>.
</p>
<p>An Assist Key click in the blank area of the modeline displays a quick
access menu of display-oriented commands.  You can jump to buffers
categorized by major mode, jump to windows by buffer name, or to
frames by name.  Manage your windows and frames quickly with this menu
as well.  As always with Hyperbole, just try it and you&rsquo;ll begin to
wonder how you lived without it before.
</p>
</li><li> Right Corner

<a name="index-Info-browser"></a>
<a name="index-modeline-click-and-drag"></a>
<a name="index-modeline_002c-Info-Browser"></a>
<p>A click of the Action Mouse Key in the right corner of a window
modeline (within the rightmost 3 characters) displays or hides the
GNU Info Manual Browser, giving you quick point and click access to
an amazing wealth of documentation, since the Action Key also browses
through these manuals and follows their hyperlinked cross-references.
A click of the Assist Key in the same location displays or hides the
Smart Key summary, as noted earlier.
</p>
</li><li> Customizable Variables

<a name="index-action_002dkey_002dmodeline_002dfunction"></a>
<a name="index-assist_002dkey_002dmodeline_002dfunction"></a>
<a name="index-action_002dkey_002dmodeline"></a>
<a name="index-assist_002dkey_002dmodeline"></a>
<a name="index-hmouse_002dcontext_002dmenu"></a>
<a name="index-hmouse_002dcontext_002dibuffer_002dmenu"></a>
<a name="index-ibuffer-menu"></a>
<p>Hyperbole modeline mouse click actions are controlled by the two functions,
<code>action-key-modeline</code> and <code>assist-key-modeline</code>.  If you know
a little Emacs Lisp you can change these to do whatever you like.  When a
Smart Key press is on a blank part of a modeline but not at the left or
right, the function given by one of these two variables is
executed: <code>action-key-modeline-function</code> or
<code>assist-key-modeline-function</code>.  By default, the Action Key toggles
between displaying and hiding the buffer menu.  If you like the more
advanced features of <code>Ibuffer Mode</code>, you can change the buffer menu to
use that with the following in your Emacs initialization file:
<code>(setq action-key-modeline-function #'hmouse-context-ibuffer-menu)</code>.
To set it back to the default use:
<code>(setq action-key-modeline-function #'hmouse-context-menu)</code>.
</p>
<a name="index-hui_002dmenu_002dscreen_002dcommands"></a>
<a name="index-modeline_002c-screen-command-menu"></a>
<p>The default <code>assist-key-modeline-function</code> is to pop up a menu of
convenient screen commands that lets you select buffers grouped by
major mode, use HyControl, or jump to specific windows, window
configurations or frames.
</p>
<p>Since these are customization options, they may be change permanently like so.
Use <kbd>{M-x customize-set-variable <span class="key">RET</span> assist-key-modeline-function <span class="key">RET</span>}</kbd>.
Change the value to your desired command.  Then press <tt class="key">RET</tt>.
</p></li></ul>

<hr>
<a name="Smart-Mouse-Key-Drags"></a>
<div class="header">
<p>
Previous: <a href="#Smart-Mouse-Key-Modeline-Clicks" accesskey="p" rel="prev">Smart Mouse Key Modeline Clicks</a>, Up: <a href="#Smart-Keys" accesskey="u" rel="up">Smart Keys</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Smart-Mouse-Key-Drags-1"></a>
<h3 class="section">2.7 Smart Mouse Key Drags</h3>

<a name="index-smart-mouse-key-drag"></a>
<a name="index-Action-Mouse-Key-drag"></a>
<a name="index-Assist-Mouse-Key-drag"></a>
<a name="index-drag_002c-Smart-Mouse-Key"></a>
<p>As mentioned in the section on Thing Selection, Hyperbole Smart Mouse Key
drag actions can be quite useful.  This section summarizes other drag
contexts and actions; for complete documentation, see <a href="#Smart-Mouse-Keys">Smart Mouse Keys</a>.
</p>
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">&bull; <a href="#Creating-and-Deleting-Windows" accesskey="1">Creating and Deleting Windows</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Saving-and-Restoring-Window-Configurations" accesskey="2">Saving and Restoring Window Configurations</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Resizing-Windows" accesskey="3">Resizing Windows</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Moving-Frames" accesskey="4">Moving Frames</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Dragging-Buffers" accesskey="5">Dragging Buffers</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
</table>

<hr>
<a name="Creating-and-Deleting-Windows"></a>
<div class="header">
<p>
Next: <a href="#Saving-and-Restoring-Window-Configurations" accesskey="n" rel="next">Saving and Restoring Window Configurations</a>, Previous: <a href="#Smart-Mouse-Key-Drags" accesskey="p" rel="prev">Smart Mouse Key Drags</a>, Up: <a href="#Smart-Mouse-Key-Drags" accesskey="u" rel="up">Smart Mouse Key Drags</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Creating-and-Deleting-Windows-1"></a>
<h4 class="subsection">2.7.1 Creating and Deleting Windows</h4>

<a name="index-drag_002c-horizontal"></a>
<a name="index-horizontal-drag"></a>
<a name="index-drag_002c-vertical"></a>
<a name="index-vertical-drag"></a>
<p>Horizontal and vertical drags of the Smart Mouse Keys are used to split and
delete Emacs windows.
</p>
<p>An Action Mouse Key horizontal drag of five or more characters in either
direction within a single window creates a new window by splitting the
current window into two windows, one atop the other.  An Action Mouse Key
vertical drag in either direction splits the current window into two
side-by-side windows.  A horizontal or vertical drag of the Assist Mouse
Key within a single window, deletes that window.
</p>
<a name="index-C_002dx-_002b"></a>
<a name="index-rebalance-windows"></a>
<a name="index-windows_002c-rebalance"></a>
<p>If you split windows many times and then delete a number of the windows,
you&rsquo;ll be left with windows of differing heights.  Use <kbd>{C-x +}</kbd> to
re-balance the sizes of the remaining windows, so they are fairly even.
</p>
<hr>
<a name="Saving-and-Restoring-Window-Configurations"></a>
<div class="header">
<p>
Next: <a href="#Resizing-Windows" accesskey="n" rel="next">Resizing Windows</a>, Previous: <a href="#Creating-and-Deleting-Windows" accesskey="p" rel="prev">Creating and Deleting Windows</a>, Up: <a href="#Smart-Mouse-Key-Drags" accesskey="u" rel="up">Smart Mouse Key Drags</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Saving-and-Restoring-Window-Configurations-1"></a>
<h4 class="subsection">2.7.2 Saving and Restoring Window Configurations</h4>

<a name="index-window-configuration-drag"></a>
<a name="index-drag_002c-window-configuration"></a>
<a name="index-drag_002c-diagonal"></a>
<a name="index-diagonal-drag"></a>
<p>A window configuration consists of the set of windows within a single Emacs
frame.  This includes their locations, buffers, and the scrolled positions of
their buffers.
</p>
<p>Hyperbole allows you to save and restore window configurations with simple
diagonal mouse drags within a single window.  A diagonal drag in any
direction of the Action Key saves the current window configuration to a
ring of window configurations, just like the Emacs text kill ring.
(See <a href="http://www.gnu.org/software/emacs/manual/html_mono/emacs.html#Kill-Ring">Kill Ring</a> in <cite>the Emacs Manual</cite>).  Each diagonal drag in any
direction of the Assist Key restores a prior saved window configuration
from the ring.  Window configurations are restored in reverse order of the
way they were saved.  Since a ring is circular, after the oldest element is
restored, the newest element will again be restored and so on.
</p>
<hr>
<a name="Resizing-Windows"></a>
<div class="header">
<p>
Next: <a href="#Moving-Frames" accesskey="n" rel="next">Moving Frames</a>, Previous: <a href="#Saving-and-Restoring-Window-Configurations" accesskey="p" rel="prev">Saving and Restoring Window Configurations</a>, Up: <a href="#Smart-Mouse-Key-Drags" accesskey="u" rel="up">Smart Mouse Key Drags</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Resizing-Windows-1"></a>
<h4 class="subsection">2.7.3 Resizing Windows</h4>

<a name="index-resizing-windows"></a>
<a name="index-drag_002c-resize-window"></a>
<p>Emacs windows may be resized by dragging their window separators
(modelines or vertical side lines) within a frame.  Simply depress either
Smart Mouse Key on a non-bottommost modeline or near a window side, hold
it down while you drag to a new location and then release.  The window
separator will move to the location of release.  Basically, just drag the
window separator to where you want it.  Drags from a blank area of a
modeline show visible feedback as the window is resized.
</p>
<hr>
<a name="Moving-Frames"></a>
<div class="header">
<p>
Next: <a href="#Dragging-Buffers" accesskey="n" rel="next">Dragging Buffers</a>, Previous: <a href="#Resizing-Windows" accesskey="p" rel="prev">Resizing Windows</a>, Up: <a href="#Smart-Mouse-Key-Drags" accesskey="u" rel="up">Smart Mouse Key Drags</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Moving-Frames-1"></a>
<h4 class="subsection">2.7.4 Moving Frames</h4>

<a name="index-dragging-frames"></a>
<a name="index-moving-frames"></a>
<a name="index-drag_002c-move-frame"></a>
<a name="index-modeline-drag_002c-move-frame"></a>
<a name="index-drag_002dwith_002dmode_002dline"></a>
<p>Drags of either Smart Key from a bottommost modeline can be configured to
drag Emacs frames to new locations on screen.  To configure all existing
and future frames for such dragging, use:
</p>
<p><code>(modify-all-frames-parameters '((drag-with-mode-line . t)))</code>.
</p>
<p>To configure just the selected frame for such dragging, use:
</p>
<p><code>(set-frame-parameter nil 'drag-with-mode-line t)</code>.
</p>
<p>on each frame you would like to drag.
</p>
<p>Then drag with either Smart Key from a bottommost modeline within a frame
to move the frame on screen with live feedback, as if you were dragging
from the titlebar.  If you use a click-to-focus window manager, click on
the desired frame first and then depress to drag.
</p>
<hr>
<a name="Dragging-Buffers"></a>
<div class="header">
<p>
Previous: <a href="#Moving-Frames" accesskey="p" rel="prev">Moving Frames</a>, Up: <a href="#Smart-Mouse-Key-Drags" accesskey="u" rel="up">Smart Mouse Key Drags</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Dragging-Buffers_002c-Windows-and-Items"></a>
<h4 class="subsection">2.7.5 Dragging Buffers, Windows and Items</h4>

<p>Smart Mouse Key drags let you display buffers and windows however you want
them.  Dired and buffer-menu items may also be displayed in specific
locations with drags.  Below we explore these drag actions.
</p>
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">&bull; <a href="#Swapping-Buffers" accesskey="1">Swapping Buffers</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Displaying-Buffers" accesskey="2">Displaying Buffers</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Cloning-Windows" accesskey="3">Cloning Windows</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Displaying-File-and-Buffer-Items" accesskey="4">Displaying File and Buffer Items</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Keyboard-Drags" accesskey="5">Keyboard Drags</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
</table>

<hr>
<a name="Swapping-Buffers"></a>
<div class="header">
<p>
Next: <a href="#Displaying-Buffers" accesskey="n" rel="next">Displaying Buffers</a>, Previous: <a href="#Dragging-Buffers" accesskey="p" rel="prev">Dragging Buffers</a>, Up: <a href="#Dragging-Buffers" accesskey="u" rel="up">Dragging Buffers</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Swapping-Buffers-1"></a>
<h4 class="subsubsection">2.7.5.1 Swapping Buffers</h4>

<a name="index-swap-buffers"></a>
<a name="index-window_002c-swap-buffer"></a>
<a name="index-buffer_002c-swap"></a>
<a name="index-drag_002c-buffer-swap"></a>
<p>Swapping buffer locations is quick and easy with Hyperbole.  Simply drag
from one window to another with the Assist Key (not the Action Key).  This
works across frames as well.
</p>
<p>If you have just two windows in an Emacs frame, you can swap their
buffers from the keyboard.  Use this Hyperbole minibuffer menu key
sequence involving the tilde key to swap the buffers and quit from the
Hyperbole minibuffer menu: <kbd>{C-h h s w ~ Q}</kbd>.  Similarly, if you
have two single window frames, you can swap buffers between them with
<kbd>{C-h h s f ~ Q}</kbd>.
</p>
<hr>
<a name="Displaying-Buffers"></a>
<div class="header">
<p>
Next: <a href="#Cloning-Windows" accesskey="n" rel="next">Cloning Windows</a>, Previous: <a href="#Swapping-Buffers" accesskey="p" rel="prev">Swapping Buffers</a>, Up: <a href="#Dragging-Buffers" accesskey="u" rel="up">Dragging Buffers</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Displaying-Buffers-1"></a>
<h4 class="subsubsection">2.7.5.2 Displaying Buffers</h4>

<a name="index-buffer_002c-copy"></a>
<a name="index-copy-buffer"></a>
<a name="index-drag_002c-copy-buffer"></a>
<p>What if you want to display the same buffer in another window and not swap
buffers?  Depress the Action Mouse Key in the open area of the modeline of
the source window and drag to the text area of the destination window.
Voila, the buffer appears in the new location as well as the old one.
</p>
<p>If you want a new window where you release (so the original destination
window&rsquo;s buffer stays onscreen), just drag to a window&rsquo;s modeline; that
window will be split before the buffer is displayed.
</p>
<hr>
<a name="Cloning-Windows"></a>
<div class="header">
<p>
Next: <a href="#Displaying-File-and-Buffer-Items" accesskey="n" rel="next">Displaying File and Buffer Items</a>, Previous: <a href="#Displaying-Buffers" accesskey="p" rel="prev">Displaying Buffers</a>, Up: <a href="#Dragging-Buffers" accesskey="u" rel="up">Dragging Buffers</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Cloning-Windows-1"></a>
<h4 class="subsubsection">2.7.5.3 Cloning Windows</h4>

<a name="index-clone-window"></a>
<a name="index-window_002c-clone"></a>
<a name="index-drag_002c-clone-window"></a>
<p>To clone a window with its buffer to a new frame, simply drag the Action Mouse
Key from the window to outside of Emacs and release the key.  A new frame will
be created, selected and sized according to the original window.  Do the same
thing with the Assist Mouse Key and the original window will be deleted as well,
unless it is the only window in that frame.
</p>
<hr>
<a name="Displaying-File-and-Buffer-Items"></a>
<div class="header">
<p>
Next: <a href="#Keyboard-Drags" accesskey="n" rel="next">Keyboard Drags</a>, Previous: <a href="#Cloning-Windows" accesskey="p" rel="prev">Cloning Windows</a>, Up: <a href="#Dragging-Buffers" accesskey="u" rel="up">Dragging Buffers</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Displaying-File-and-Buffer-Items-1"></a>
<h4 class="subsubsection">2.7.5.4 Displaying File and Buffer Items</h4>

<a name="index-dired-item-drag"></a>
<a name="index-buffer-menu-item-drag"></a>
<a name="index-Treemacs-item-drag"></a>
<a name="index-drag_002c-dired-item"></a>
<a name="index-drag_002c-buffer-menu-item"></a>
<a name="index-drag_002c-Treemacs-item"></a>
<p>You can also drag items to other windows with the Action Key in Dired,
Buffer Menu, Ibuffer and Treemacs listing buffers, rather than the
buffers themselves.  Drag with the Action Mouse Key and the selected
item will be displayed in any Emacs window in which you release.  Drag
outside Emacs and it will be displayed in a new frame.  To display the
last item you want within the listing window itself, press and release
the Action Key on that item after dragging your other items to their
respective windows.  Remember that you can emulate these drags from
the keyboard when needed, see <a href="#Keyboard-Drags">Keyboard Drags</a>.
</p>
<p>So now you can put a bunch of buffers and files on your screen wherever
you like.  Typically, a brief visual pulse is shown first at the source item and
then in the destination window, to help you see that the transfer has been
made.  An Assist Key Drag will move the the item list buffer to the
destination (swapping buffers), just as it does with other buffers.
</p>
<hr>
<a name="Keyboard-Drags"></a>
<div class="header">
<p>
Previous: <a href="#Displaying-File-and-Buffer-Items" accesskey="p" rel="prev">Displaying File and Buffer Items</a>, Up: <a href="#Dragging-Buffers" accesskey="u" rel="up">Dragging Buffers</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Keyboard-Drags-1"></a>
<h4 class="subsubsection">2.7.5.5 Keyboard Drags</h4>

<a name="index-M_002do"></a>
<a name="index-C_002du-M_002do"></a>
<a name="index-C_002dx-o"></a>
<a name="index-hkey_002doperate"></a>
<a name="index-drag-emulation"></a>
<a name="index-emulation_002c-drag"></a>
<a name="index-keyboard-drags"></a>
<p>If you run Emacs under a window system and there is no prior key binding
on <kbd>{M-o}</kbd> when you load Hyperbole, then many Action Key drags can be
emulated from the keyboard.  To do so, press <kbd>{M-o}</kbd>, the
<code>hkey-operate</code> command, at the button source location, move
to the link destination, e.g. with <kbd>{C-x o}</kbd>, and then press
<kbd>{M-o}</kbd> again.  This simulates a depress and release of the
Action Key.  <kbd>{C-u M-o}</kbd> emulates drags of the Assist Key.
This will not work when Hyperbole is run from a dumb terminal Emacs
session since drag actions are not supported without a window system.
</p>
<a name="index-ace_002dwindow-1"></a>
<a name="index-hkey_002dace_002dwindow_002dsetup"></a>
<a name="index-ace_002dwindow"></a>
<a name="index-window-by-letter"></a>
<a name="index-jump-to-window-by-letter"></a>
<a name="index-keyboard_002c-jump-to-window"></a>
<p>For even faster keyboard-based display of items and drag emulations,
use the Emacs package <code>ace-window</code>
(see <a href="https://elpa.gnu.org/packages/ace-window.html">https://elpa.gnu.org/packages/ace-window.html</a>).
</p>
<p>The ace-window package assigns short letter IDs to each Emacs window and lets
you jump to or operate upon a specific window by giving its ID.  Hyperbole can
add commands to ace-window that replace the two-step drag emulation key
described above with a single key sequence that does not require moving to
the drag target window since it is specified by ID as part of the command.
</p>
<p>To enable this feature, in your Emacs initialization file after
Hyperbole is initialized, if you do not have a key bound for
<code>ace-window</code>, then call: <code>(hkey-ace-window-setup \&quot;\M-o\&quot;)</code>
to bind it to <kbd>{M-o}</kbd>, replacing Hyperbole&rsquo;s
default <code>hkey-operate</code> command there (because ace-window can emulate
the drags performed by <code>hkey-operate</code>).  If you already have a key bound
for <code>ace-window</code>, then just ensure it is initialized by calling
<code>(hkey-ace-window-setup)</code> without a key argument.
</p>
<a name="index-M_002do-i-_003cwindow_002did_003e"></a>
<a name="index-M_002do-m-_003cwindow_002did_003e"></a>
<a name="index-M_002do-r-_003cwindow_002did_003e"></a>
<a name="index-M_002do-t-_003cwindow_002did_003e"></a>
<a name="index-M_002do-w-_003cwindow_002did_003e"></a>
<a name="index-insert-item"></a>
<a name="index-drag-item"></a>
<a name="index-replace-window-buffer"></a>
<a name="index-swap-window-buffers"></a>
<a name="index-throw-item"></a>
<a name="index-buffer-replace"></a>
<a name="index-buffers-swap"></a>
<a name="index-create-link-button"></a>
<a name="index-window-link-button"></a>
<a name="index-link-button"></a>
<a name="index-item-drag"></a>
<a name="index-item-insert"></a>
<a name="index-item-throw"></a>
<p>After setup, the leftmost character or two of each window&rsquo;s modeline
will show the ID to type to use that window as the drag destination.
Then whenever point is on an item you want displayed in another
window, use <kbd>{M-o i &lt;id-of-window-to-display-item-in&gt;}</kbd> and watch
the magic happen.  If you want to display multiple items in different
windows, instead use the <kbd>{M-o t
&lt;id-of-window-to-display-item-in&gt;}</kbd> key sequence to <em>throw</em> the
item to the window.  To <em>replace</em> the selected window&rsquo;s buffer
with that of another window, use <kbd>{M-o r
&lt;id-of-window-displaying-desired-buffer&gt;}</kbd>.  To instead <em>swap</em> the
selected window&rsquo;s buffer with that of another window, use <kbd>{M-o m
&lt;id-of-window-to-swap-with&gt;}</kbd>.  And finally, to quickly create a link
between the selected window and another window, use <kbd>{M-o w
&lt;id-of-referent-window&gt;}</kbd>.
</p>
<a name="index-throw-region"></a>
<a name="index-region-throw"></a>
<p>You can also throw the active (highlighted) region of text to another
window.  Simply activate a region and then use <kbd>{M-o
t &lt;window-id&gt;}</kbd>.  If you don&rsquo;t use region highlighting,
i.e. <code>transient-mark-mode</code>, then use <kbd>{C-u M-o
t &lt;window-id&gt;}</kbd> for the same effect.  The buffer in the target window
must differ from the one in the source window.  With no region active,
this command throws the source buffer to the target window.
</p>
<p>In summary:
</p>
<dl compact="compact">
<dt>M-o i &lt;window&gt;</dt>
<dd><p>insert listing item at point into &lt;window&gt;; if not on a listing item,
trigger an error
</p>
</dd>
<dt>M-o m &lt;window&gt;</dt>
<dd><p>swap the buffers in the selected window and &lt;window&gt;
</p>
</dd>
<dt>M-o r &lt;window&gt;</dt>
<dd><p>replace the selected (current) window&rsquo;s buffer with that of &lt;window&gt;
</p>
</dd>
<dt>M-o t &lt;window&gt;</dt>
<dd><p>throw region, listing item at point, or current buffer to &lt;window&gt;
</p>
</dd>
<dt>M-o w &lt;window&gt;</dt>
<dd><p>window link, create a new explicit button in the selected (current)
window, linking to point in the referent &lt;window&gt;, with the link type
determined by the referent context via <code>hui:link-directly</code>.
</p></dd>
</dl>








<hr>
<a name="Buttons"></a>
<div class="header">
<p>
Next: <a href="#Menus" accesskey="n" rel="next">Menus</a>, Previous: <a href="#Smart-Keys" accesskey="p" rel="prev">Smart Keys</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Buttons-1"></a>
<h2 class="chapter">3 Buttons</h2>

<a name="index-button"></a>
<p>This chapter explains use of Hyperbole <em>buttons</em>.  There are several
kinds of Hyperbole buttons: buttons that are created one at a time and
stored in files (<em>explicit buttons</em>); buttons that can be
activated by name anytime (<em>global buttons</em>); and buttons defined
by textual patterns where one definition can create an infinite number
of buttons (<em>implicit buttons</em>).
</p>
<p>Hyperbole buttons are embedded within textual documents; they may be
created, modified, moved or deleted.  Each button performs a specific
action, such as linking to a file or executing a shell command.
</p>
<a name="index-button_002c-explicit"></a>
<a name="index-button_002c-global"></a>
<a name="index-button_002c-implicit"></a>
<a name="index-button-category"></a>
<a name="index-explicit-button"></a>
<a name="index-global-button"></a>
<a name="index-implicit-button"></a>
<p>There are three categories of Hyperbole buttons:
</p><dl compact="compact">
<dt><em>explicit buttons</em></dt>
<dd><p>created by Hyperbole, accessible from within a single document;
</p>
</dd>
<dt><em>global buttons</em></dt>
<dd><p>created by Hyperbole, specific to each user, and accessible anywhere
within a user&rsquo;s network of documents;
</p>
</dd>
<dt><em>implicit buttons</em></dt>
<dd><p>created and managed by other programs or embedded within the structure
of a document, accessible from within a single document.  Hyperbole
recognizes implicit buttons by contextual patterns given in their type
specifications (explained later).
</p></dd>
</dl>

<p>Explicit Hyperbole buttons may be embedded within any type of text file.
Implicit buttons may appear only within document contexts allowed by
their types, which may limit the kinds of documents or the locations
within those documents at which such buttons may be found.  All global
buttons for a user are stored in a single location and are activated by
typing their names, rather than by direct selection, the means used to
activate explicit and implicit buttons.
</p>
<p>To summarize:
</p>
<div class="example">
<pre class="example">Button Category   Active Within        Activation Means      Managed By
========================================================================
Explicit          a single document    direct selection      Hyperbole
Global            any document         typing its name       Hyperbole
Implicit          a matching context   direct selection      other tools

</pre></div>

<a name="index-terminal-use"></a>
<p>A click on a Hyperbole button may activate it or describe its actions,
depending on which mouse key is used.  Buttons may also be activated from a
keyboard.  (In fact, many Hyperbole operations, including menu usage, may
be performed from any standard character terminal interface, so you need
not be anchored to a desktop all day).  See <a href="#Smart-Keys">Smart Keys</a>.  There is
also a key that shows you how a button will behave before you activate
it, see <a href="#Smart-Key-Operations">Smart Key Operations</a>.
</p>
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">&bull; <a href="#Explicit-Buttons" accesskey="1">Explicit Buttons</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Global-Buttons" accesskey="2">Global Buttons</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Implicit-Buttons" accesskey="3">Implicit Buttons</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Button-Files" accesskey="4">Button Files</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Action-Types" accesskey="5">Action Types</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Button-Type-Precedence" accesskey="6">Button Type Precedence</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Utilizing-Explicit-Buttons" accesskey="7">Utilizing Explicit Buttons</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
</table>

<hr>
<a name="Explicit-Buttons"></a>
<div class="header">
<p>
Next: <a href="#Global-Buttons" accesskey="n" rel="next">Global Buttons</a>, Previous: <a href="#Buttons" accesskey="p" rel="prev">Buttons</a>, Up: <a href="#Buttons" accesskey="u" rel="up">Buttons</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Explicit-Buttons-1"></a>
<h3 class="section">3.1 Explicit Buttons</h3>

<a name="index-explicit-button-1"></a>
<a name="index-button_002c-explicit-1"></a>
<a name="index-button-label"></a>
<a name="index-button-name"></a>
<a name="index-label_002c-button"></a>
<a name="index-name_002c-button"></a>
<p>Hyperbole creates and manages <em>explicit buttons</em> which perform
specific actions when activated (typically through a button press).
They look like this &lsquo;<samp>&lt;(fake button)&gt;</samp>&rsquo;.  They are quickly
recognizable, yet relatively non-distracting as you scan the text in
which they are embedded.  The text between the &lsquo;<samp>&lt;(</samp>&rsquo; and &lsquo;<samp>)&gt;</samp>&rsquo;
delimiters is called the <em>button label</em> or <em>button name</em>.
Spacing between words within a button label is irrelevant to Hyperbole.
Button labels may wrap across several lines without causing a problem;
just be sure to select the first line of the button to activate it.
</p>
<p>Explicit buttons may be added to any editable text file; for source
code files, simply place buttons within comments.  Buttons that you
use for quick navigation to websites or other things you do often
should be added to your personal button file.  See <a href="#Button-Files">Button Files</a>.
</p>
<a name="index-button_002c-moving"></a>
<a name="index-moving-buttons"></a>
<p>Explicit buttons may be freely moved about within the buffer in which
they are created.  (No present support exists for moving buttons between
buffers; support the Hyperbole project if you would like to help make
this happen).  A single button may also appear multiple times within the
same buffer; simply copy the button label with its delimiters
to a new location if you need another copy of it.
</p>
<p>For details on how to create, activate, delete or modify explicit
buttons, see <a href="#Utilizing-Explicit-Buttons">Utilizing Explicit Buttons</a>.
</p>
<a name="index-link-button-1"></a>
<a name="index-referent"></a>
<p>Each explicit button is assigned an action type that determines the actions
it performs.  <em>Link action types</em> connect buttons to particular types
of <em>referents</em>, the targets of their links.  Link action type names all
begin with <code>link-</code>.  Link action button referents are displayed when
such buttons are activated with a press or a click.  See <a href="#Action-Types">Action Types</a>,
for a list of standard action types including link types.
</p>
<a name="index-linking_002c-in_002dplace"></a>
<a name="index-Hyperbole-data-model"></a>
<p>Hyperbole does not manage referent data; this is left to the
applications that generate the data.  This means that Hyperbole
provides in-place linking and does not require reformatting data to
integrate it with Hyperbole.
</p>
<a name="index-button-data"></a>
<a name="index-button-attribute"></a>
<a name="index-file_002c-_002ehypb"></a>
<p>Hyperbole stores the <em>button data</em> that gives an explicit button its
behavior, separately from the button label, in a file named
<samp>.hypb</samp> (<samp>_hypb</samp> under MS Windows) within the same directory
as the file in which the button is created.  Thus, all files in the
same directory share a common button data file.  Button data is
comprised of individual <em>button attribute</em> values.  A user never
sees this data in its raw form but may see a formatted version by
asking for help on a button.
</p>

<hr>
<a name="Global-Buttons"></a>
<div class="header">
<p>
Next: <a href="#Implicit-Buttons" accesskey="n" rel="next">Implicit Buttons</a>, Previous: <a href="#Explicit-Buttons" accesskey="p" rel="prev">Explicit Buttons</a>, Up: <a href="#Buttons" accesskey="u" rel="up">Buttons</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Global-Buttons-1"></a>
<h3 class="section">3.2 Global Buttons</h3>

<a name="index-global-button-1"></a>
<a name="index-button_002c-global-1"></a>
<a name="index-button-label-1"></a>
<a name="index-label_002c-button-1"></a>
<p>Sometimes it is
useful to activate buttons without regard to the information with which
you are working.  In such instances, you use <em>global buttons</em>, which
are buttons that may be activated or otherwise operated upon by typing
their labels/names when they are prompted for, rather than selecting the
buttons within a buffer.  In contrast, activation of explicit buttons
depends upon the information on your screen since they are accessible
only from within their particular buffers.
</p>
<p>If you want a permanent link to a file section that you can follow at
any time, you can use a global button.  Or what about an Emacs keyboard
macro that you use frequently?  Create a global button with an action type
of <code>exec-kbd-macro</code> button and an easy to type name.  Then you can
activate it whenever the need arises.
</p>
<a name="index-C_002dh-h-g"></a>
<a name="index-menu_002c-Gbut"></a>
<a name="index-menu_002c-Global_002dButton"></a>
<p>Global buttons are managed with the Hyperbole Gbut/ menu accessed with
<kbd>{C-h h g}</kbd>.  The Create item, <kbd>{C-h h g c}</kbd>, prompts for a
global button name, an action type, and the action&rsquo;s associated
arguments, such as a file to link to.  It then creates the button.  To
activate the button, use the Act menu item, <kbd>{C-h h g a}</kbd>.  Type
the button&rsquo;s name and its action will be  To remove the
button, use the Delete menu item, <kbd>{C-h h g d}</kbd>; see <a href="#Deletion">Deletion</a>.
</p>
<p>Global buttons are actually explicit buttons stored at the end of your
personal button file, see <a href="#Button-Files">Button Files</a>.  You can always go into that
file and activate, edit or annotate these buttons with comments.
</p>
<a name="index-bookmarks"></a>
<p>Emacs has a built-in feature similar to Global Buttons called
Bookmarks.  Bookmarks store places in files or link to URLs, so they
are more limited than Hyperbole&rsquo;s global buttons and cannot utilize
all of Hyperbole&rsquo;s capabilities for performing actions.  Hyperbole has
an action type, <code>link-to-bookmark</code>, for using an Emacs bookmark
as a Hyperbole button referent.  See <a href="http://www.gnu.org/software/emacs/manual/html_mono/emacs.html#Bookmarks">Bookmarks</a> in <cite>the Emacs
Manual</cite>, for details on bookmarks.
</p>
<hr>
<a name="Implicit-Buttons"></a>
<div class="header">
<p>
Next: <a href="#Button-Files" accesskey="n" rel="next">Button Files</a>, Previous: <a href="#Global-Buttons" accesskey="p" rel="prev">Global Buttons</a>, Up: <a href="#Buttons" accesskey="u" rel="up">Buttons</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Implicit-Buttons-1"></a>
<h3 class="section">3.3 Implicit Buttons</h3>

<a name="index-button_002c-implicit-1"></a>
<a name="index-implicit-button-1"></a>
<a name="index-link_002dto_002dfile"></a>
<p><em>Implicit buttons</em> are virtual buttons recognized within the
natural structure of a document.  For example, a web URL button that
displays its link or an email address button that starts a mail
message to the associated address.  Implicit buttons are identified by
contextual patterns found within documents.
</p>
<p>An <em>implicit button type</em> identifies a pattern or state that when
matched triggers an <em>action</em> associated with the implicit button
type.  The action is specified by either a Hyperbole action type
(see <a href="#Action-Types">Action Types</a>) or an Emacs Lisp function.  Implicit button
types may use the same action types that explicit buttons use.  As an
example, the pathname implicit button type matches to any existing
local filename or directory name and its action
type, <code>link-to-file</code>, displays the associated file or directory,
typically in another window.  An explicit button could do the same
thing but has to be created manually, rather than recognized as part
of the buffer text.
</p>
<a name="index-file_002c-hibtypes_002eel"></a>
<a name="index-context"></a>
<a name="index-boolean-expressions"></a>
<a name="index-activating-implicit-button"></a>
<a name="index-menu-item_002c-Ibut_002fAct"></a>
<a name="index-C_002dh-h-i-a"></a>
<p>Unlike explicit buttons, implicit buttons have no individual button
data other than their text and optional labels.  You use implicit
button types which include boolean expressions (predicates) that match
to both the label and the context required of any button of the type.
Each time a Smart Key is pressed at a location, Hyperbole evaluates
the predicates from the list of implicit button types and the first
one that evaluates true is selected and its associated action is
triggered.  Alternatively, you can use the Ibut/Act menu
item, <kbd>{C-h h i a}</kbd>, to activate any implicit button found at the
current point.
</p>
<p>All of this happens transparently and is easy to use once you try it.
The Hyperbole Smart Keys offer additional extensive context-sensitive
point-and-click type behavior beyond implicit button types.  See <a href="#Smart-Key-Operations">Smart Key Operations</a>.
</p>
<a name="index-implicit-button-labels"></a>
<a name="index-labeling-implicit-buttons"></a>
<a name="index-naming-implicit-buttons"></a>
<p>Individual implicit buttons may be labeled/named, allowing activation
by name or use as a link target by other buttons.  Here is a pathname
button with a label of &rsquo;My Emacs Files&rsquo;:
</p>
<div class="example">
<pre class="example">&lt;[My Emacs Files]&gt;: &quot;~/.emacs.d&quot;
</pre></div>

<p>The label is delimited by &lsquo;<samp>&lt;[</samp>&rsquo; and &lsquo;<samp>]&gt;</samp>&rsquo; and can be followed
by any number of :, - or = separator characters, including none.  You
can activate the button either from its label or its text.  With point
on the text of an implicit button, <kbd>{C-h h i l}</kbd> will label it.  Or
you may simply type the label and delimiters manually.
</p>
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">&bull; <a href="#Implicit-Button-Types" accesskey="1">Implicit Button Types</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Action-Buttons" accesskey="2">Action Buttons</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
</table>

<hr>
<a name="Implicit-Button-Types"></a>
<div class="header">
<p>
Next: <a href="#Action-Buttons" accesskey="n" rel="next">Action Buttons</a>, Previous: <a href="#Implicit-Buttons" accesskey="p" rel="prev">Implicit Buttons</a>, Up: <a href="#Implicit-Buttons" accesskey="u" rel="up">Implicit Buttons</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Implicit-Button-Types-1"></a>
<h4 class="subsection">3.3.1 Implicit Button Types</h4>

<a name="index-ibtypes_002c-list-of"></a>
<a name="index-implicit-button-types"></a>
<p>Below is a list of standard implicit button types in the order in which
Hyperbole tries to match to the types when looking for an implicit
button; <kbd>{C-h h i t <span class="key">RET</span>}</kbd> provides similar information.  See
the Hyperbole file, <samp>hibtypes.el</samp>, for examples of how to define
implicit button types (they are listed in increasing order of priority).
</p>
<dl compact="compact">
<dd>
<a name="index-ibtypes-doc_002did"></a>
<a name="index-online-library"></a>
<a name="index-document-identifier"></a>
</dd>
<dt><code>doc-id</code></dt>
<dd><p>Display a document from a local document library given its id.  Ids must be
delimited by <code>doc-id-start</code> and <code>doc-id-end</code> and must match the
function given by <code>doc-id-p</code>.  (Note that this implicit button type is
not installed by default.  You must manually configure it and load it from
the file, <samp><code>${hyperb:dir}</code>/hib-doc-id.el</samp>).  See the commentary
at the top of that file for more information.
</p>
<a name="index-ibtypes-completion"></a>
<a name="index-completion-1"></a>
</dd>
<dt><code>completion</code></dt>
<dd><p>Insert the completion at point (from a completions buffer) into the
minibuffer or the other window.
</p>
<a name="index-ibtypes-hyp_002dsource"></a>
<a name="index-Hyperbole-report"></a>
</dd>
<dt><code>hyp-source</code></dt>
<dd><p>Turn source location entries following an &lsquo;@loc&gt;&rsquo; line in Hyperbole
reports into buttons that jump to the associated location.  For
example, <kbd>{C-h h d d C-h h e h o}</kbd> summarizes the properties of the
explicit buttons in the <samp>DEMO</samp> file and each button in that report
buffer behaves the same as the corresponding button in the original
<samp>DEMO</samp> file.
</p>
<a name="index-ibtypes-hyp_002daddress"></a>
<a name="index-Hyperbole-mail-list"></a>
</dd>
<dt><code>hyp-address</code></dt>
<dd><p>Within a mail or Usenet news composer window, make a Hyperbole
support/discussion e-mail address insert Hyperbole environment and
version information.  This is useful when sending mail to a Hyperbole
discussion mail list.  See also the documentation for
<code>actypes::hyp-config</code>.  For example, a click of an Action Mouse
Key on &lt;hyperbole-users@gnu.org&gt; in a mail composer window
would activate this implicit button type.
</p>
<a name="index-ibtypes-Info_002dnode"></a>
<a name="index-Info-node"></a>
</dd>
<dt><code>Info-node</code></dt>
<dd><p>Make a &quot;(filename)nodename&quot; button display the associated Info node.
Also make a &quot;(filename)itemname&quot; button display the associated Info
index item.  Examples are &quot;(hyperbole)Implicit Buttons&quot; and
&ldquo;(hyperbole)C-c /&rdquo;.
</p>
<a name="index-ibtypes-gnus_002dpush_002dbutton"></a>
<a name="index-GNUS-push_002dbuttons"></a>
<a name="index-hiding-signatures"></a>
<a name="index-signatures_002c-hiding"></a>
</dd>
<dt><code>gnus-push-button</code></dt>
<dd><p>Activate GNUS-specific article push-buttons, e.g. for hiding signatures.  GNUS
is a news and mail reader.
</p>
<a name="index-ibtypes-texinfo_002dref"></a>
<a name="index-Texinfo-cross_002dreference"></a>
<a name="index-cross_002dreference_002c-Texinfo"></a>
</dd>
<dt><code>texinfo-ref</code></dt>
<dd><p>Display Texinfo, Info node or help associated with Texinfo node, menu item,
@xref, @pxref, @ref, @code, @findex, @var or @vindex at point.  If
point is within the braces of a cross-reference, the associated Info node is
shown.  If point is to the left of the braces but after the @ symbol and the
reference is to a node within the current Texinfo file, then the Texinfo node
is shown.
</p>
<p>For @code, @findex, @var and @vindex references, the associated
documentation string is displayed.
</p>
<a name="index-ibtypes-mail_002daddress"></a>
<a name="index-e_002dmail-address"></a>
<a name="index-rolo-address"></a>
<a name="index-address"></a>
</dd>
<dt><code>mail-address</code></dt>
<dd><p>If on an e-mail address in a specific buffer type, compose mail to that
address in another window. Applies to the rolo match buffer, any buffer
attached to a file in <code>hyrolo-file-list</code>, or any buffer
with <samp>mail</samp> or <samp>rolo</samp> (case-insensitive) within its name.
</p>
<a name="index-ibtypes-patch_002dmsg"></a>
<a name="index-patch-output"></a>
</dd>
<dt><code>patch-msg</code></dt>
<dd><p>Jump to the source code associated with output from the &lsquo;<samp>patch</samp>&rsquo;
program.  Patch applies diffs to source code.
</p>
<a name="index-ibtypes-elisp_002dcompiler_002dmsg"></a>
<a name="index-byte-compiler-error"></a>
<a name="index-Emacs-Lisp-compiler-error"></a>
<a name="index-compiler-error"></a>
</dd>
<dt><code>elisp-compiler-msg</code></dt>
<dd><p>Jump to the source code for a definition associated with an Emacs Lisp
byte-compiler error message.  This works anywhere within an error line.
</p>
<a name="index-ibtypes-debugger_002dsource"></a>
<a name="index-gdb"></a>
<a name="index-dbx"></a>
<a name="index-xdb"></a>
<a name="index-stack-frame"></a>
<a name="index-breakpoint"></a>
<a name="index-source-line"></a>
</dd>
<dt><code>debugger-source</code></dt>
<dd><p>Jump to the source line associated with a debugger stack frame or
breakpoint line.  This works with gdb, dbx, and xdb.  Such lines are
recognized in any buffer.
</p>
<a name="index-ibtypes-ripgrep_002dmsg"></a>
<a name="index-grep"></a>
<a name="index-ripgrep"></a>
<a name="index-match-lines"></a>
</dd>
<dt><code>ripgrep-msg</code></dt>
<dd><p>Jump to a line associated with a ripgrep (rg) line numbered msg.
Ripgrep outputs each pathname once, followed by all matching lines in
that pathname.  Messages are recognized in any buffer (other than a
helm completion buffer).
</p>
<a name="index-ibtypes-ipython_002dstack_002dframe"></a>
<a name="index-ipython"></a>
<a name="index-stack-frame-1"></a>
</dd>
<dt><code>ipython-stack-frame</code></dt>
<dd><p>Jump to the line associated with an ipython stack frame line numbered
msg.  ipython outputs each pathname once followed by all matching
lines in that pathname.  Messages are recognized in any buffer (other
than a helm completion buffer).
</p>
<a name="index-ibtypes-grep_002dmsg"></a>
<a name="index-grep-1"></a>
<a name="index-compiler-error-1"></a>
<a name="index-match-lines-1"></a>
</dd>
<dt><code>grep-msg</code></dt>
<dd><p>Jump to the line associated with a grep or compilation error message.
Messages are recognized in any buffer.
</p>
<a name="index-ibtypes-ilink"></a>
<a name="index-implicit-button-link"></a>
<a name="index-link-to-implicit-button"></a>
<a name="index-ilink"></a>
</dd>
<dt><code>link-to-ibut &lt;ilink&gt;</code></dt>
<dd><p>At point, activate a link to an implicit button within the current
buffer.  This executes the linked to implicit button&rsquo;s action in the
context of the current buffer.
</p>
<p>Recognizes the format &rsquo;&lt;ilink:&rsquo; button_label [&rsquo;:&rsquo; button_file_path] &rsquo;&gt;&rsquo;,
where button_file_path is given only when the link is to another file,
e.g. &lt;ilink: my series of keys: ${hyperb:dir}/HYPB&gt;.
</p>
<a name="index-ibtypes-glink"></a>
<a name="index-global-button-link"></a>
<a name="index-link-to-global-button"></a>
<a name="index-glink"></a>
</dd>
<dt><code>link-to-gbut &lt;glink&gt;</code></dt>
<dd><p>At point, activate a link to a global button.  This executes the
linked to global button&rsquo;s action in the context of the current buffer.
</p>
<p>Recognizes the format &rsquo;&lt;glink:&rsquo; button_label &rsquo;&gt;&rsquo;, e.g. &lt;glink: open todos&gt;.
</p>
<a name="index-ibtypes-elink"></a>
<a name="index-explicit-button-link"></a>
<a name="index-link-to-explicit-button"></a>
<a name="index-elink"></a>
</dd>
<dt><code>link-to-ebut &lt;elink&gt;</code></dt>
<dd><p>At point, activate a link to an explicit button within the current
buffer.  This executes the linked to explicit button&rsquo;s action in the
context of the current buffer.
</p>
<p>Recognizes the format &rsquo;&lt;elink:&rsquo; button_label [&rsquo;:&rsquo; button_file_path] &rsquo;&gt;&rsquo;,
where : button_file_path is given only when the link is to another file,
e.g. &lt;elink: project-list: ~/projs&gt;.&quot;
</p>
<a name="index-ibtypes-klink"></a>
<a name="index-klink"></a>
<a name="index-koutline-link"></a>
<a name="index-kcell-link"></a>
</dd>
<dt><code>klink</code></dt>
<dd><p>Follow a link delimited by &lt;&gt; to a koutline cell.
See the documentation for <code>actypes::link-to-kotl</code> for valid link
specifiers.
</p>
<a name="index-ibtypes-man_002dapropos"></a>
<a name="index-UNIX-manual"></a>
<a name="index-man-pages"></a>
<a name="index-man-apropos"></a>
</dd>
<dt><code>man-apropos</code></dt>
<dd><p>Make man apropos entries (from &lsquo;<samp>man -k</samp>&rsquo;) display associated man pages
when selected.
</p>
<a name="index-ibtypes-rfc"></a>
<a name="index-Internet-RFC"></a>
<a name="index-Request-For-Comment"></a>
<a name="index-RFC"></a>
<a name="index-remote-file"></a>
<a name="index-ftp"></a>
</dd>
<dt><code>rfc</code></dt>
<dd><p>Retrieve and display an Internet Request for Comments (RFC) standards
document referenced at point.  The following formats are recognized:
RFC822, rfc-822, and RFC 822.  The <code>hpath:rfc</code> variable specifies
the location from which to retrieve RFCs.  Requires the Emacs builtin
Tramp library for ftp file retrievals.
</p>
<a name="index-ibtypes-kbd_002dkey"></a>
<a name="index-key-sequence"></a>
<a name="index-sequence-of-keys"></a>
</dd>
<dt><code>kbd-key</code></dt>
<dd><p>Execute a key series (series of key sequences) around point,
delimited by curly braces, {}.  Key series should be in
human readable form, e.g. <kbd>{C-x C-b}</kbd>.  Formats such as {^x^b}
will not be recognized.
</p>
<p>Any key sequence must be a string of one of the following:
</p><ul>
<li> a Hyperbole minibuffer menu item key sequence,
</li><li> a HyControl key sequence,
</li><li> a M-x extended command,
</li><li> or a valid key sequence together with its interactive arguments.
</li></ul>

<a name="index-ibtypes-dir_002dsummary"></a>
<a name="index-file_002c-MANIFEST"></a>
<a name="index-file_002c-DIR"></a>
</dd>
<dt><code>dir-summary</code></dt>
<dd><p>Detect filename buttons in files named &quot;MANIFEST&quot; or &quot;DIR&quot;.  Display selected
files.  Each filename must be at the beginning of the line and must be
followed by one or more spaces and then another non-space, non-parenthesis,
non-brace character.
</p>
<a name="index-ibtypes-text_002dtoc"></a>
<a name="index-table-of-contents"></a>
<a name="index-toc-implicit-button-type"></a>
</dd>
<dt><code>text-toc</code></dt>
<dd><p>Jump to the text file section referenced by a table of contents (toc)
entry at point.  The filename of the current buffer must contain
<samp>README</samp> and there must be a &lsquo;Table of Contents&rsquo; or &lsquo;Contents&rsquo;
label on a line by itself (it may begin with an asterisk), preceding
the table of contents.  Each toc entry must begin with some whitespace
followed by one or more asterisk characters.  Each section header
linked to by the toc must start with one or more asterisk characters
at the very beginning of the line.
</p>
<a name="index-ibtypes-cscope"></a>
<a name="index-C_002fC_002b_002b-call-trees"></a>
<a name="index-C_002fC_002b_002b-cross_002dreference"></a>
<a name="index-Cscope"></a>
</dd>
<dt><code>cscope</code></dt>
<dd><p>Jump to a C/C++ source line associated with a Cscope C analyzer output line.
The cscope.el Lisp library available from the Emacs package manager
must be loaded and the open source cscope program available from
http://cscope.sf.net must be installed for this button type to do
anything.
</p>
<a name="index-ibtypes-etags"></a>
<a name="index-etags-entry"></a>
<a name="index-TAGS-file"></a>
<a name="index-tag"></a>
</dd>
<dt><code>etags</code></dt>
<dd><p>Jump to the source line associated with an etags file entry in a TAGS buffer.
If on a tag entry line, jump to the source line for the tag.  If on a
pathname line or line preceding it, jump to the associated file.
</p>
<a name="index-ibtypes-ctags"></a>
<a name="index-ctags-entry"></a>
<a name="index-tags-file"></a>
</dd>
<dt><code>ctags</code></dt>
<dd><p>Jump to the source line associated with a ctags file entry in any buffer.
Ctags files are used by old editors like vi to lookup identifiers.
Emacs uses the newer, more flexible Etags format.
</p>
<a name="index-ibtypes-id_002dcflow"></a>
<a name="index-C-call-tree"></a>
<a name="index-call-tree_002c-C"></a>
<a name="index-C-flow-graph"></a>
</dd>
<dt><code>id-cflow</code></dt>
<dd><p>Expand or collapse C call trees and jump to code definitions.
Requires cross-reference tables built by the external <code>cxref</code>
program.
</p>
<a name="index-ibtypes-rfc_002dtoc"></a>
<a name="index-Internet-RFC-1"></a>
<a name="index-Request-For-Comment-1"></a>
<a name="index-RFC-1"></a>
<a name="index-table-of-contents-1"></a>
</dd>
<dt><code>rfc-toc</code></dt>
<dd><p>Summarize contents of an Internet rfc from anywhere within an rfc buffer.
Each line of the summary may be selected to jump to the associated section.
</p>
<a name="index-ibtypes-actions"></a>
<a name="index-action-implicit-button"></a>
<a name="index-functon-call-implicit-button"></a>
<a name="index-variable-display-implicit-button"></a>
</dd>
<dt><code>action</code></dt>
<dd><p>Execute an angle bracket delimited Hyperbole action, Elisp function call or
display of an Elisp variable and its value.
</p>
<a name="index-ibtypes-markdown_002dinternal_002dlink"></a>
<a name="index-markdown-link"></a>
</dd>
<dt><code>markdown-internal-link</code></dt>
<dd><p>Display any in-file Markdown link referent.  Pathnames and urls are
handled elsewhere.
</p>
<a name="index-ibtypes-git_002dreference"></a>
<a name="index-git-reference"></a>
<a name="index-version-control"></a>
<a name="index-hibtypes_002dgit_002ddefault_002dproject"></a>
</dd>
<dt><code>git-reference</code></dt>
<dd><p>Display the git entity associated with REFERENCE and optional PROJECT.
See <samp>DEMO#Git (Local) References</samp> for examples.
</p>
<p>REFERENCE is a string of one of the following forms:
</p><ul>
<li> &lt;ref-item&gt;
</li><li> /?&lt;project&gt;/&lt;ref-item&gt;
</li><li> /&lt;project&gt;.
</li></ul>

<p>&lt;ref-item&gt; is one of these:
</p><dl compact="compact">
<dt>one of the words: branches, commits, or tags</dt>
<dd><p>the associated items are listed
</p></dd>
<dt>one of the words: branch, commit, or tag followed by a &rsquo;/&rsquo; and item id</dt>
<dd><p>the item is shown
</p></dd>
<dt>a commit reference given by a hex number, 55a1f0</dt>
<dd><p>the commit diff is displayed
</p></dd>
<dt>a branch or tag reference given by an alphanumeric name, e.g. hyper20</dt>
<dd><p>the files in the branch are listed.
</p></dd>
</dl>

<a name="index-hibtypes_002dgit_002ddefault_002dproject-1"></a>
<p>If given, PROJECT overrides any project value in REFERENCE.  If no PROJECT
value is provided, it defaults to the value of <code>hibtypes-git-default-project</code>. 
</p>
<a name="index-ibtypes-git_002dcommit_002dreference"></a>
<a name="index-git-commit-reference"></a>
<a name="index-version-control-1"></a>
</dd>
<dt><code>git-commit-reference</code></dt>
<dd><p>Display the diff for a git commit reference, e.g. commit a55e21, typically
produced by git log.
</p>
<a name="index-ibtypes-github_002dreference"></a>
<a name="index-github-reference"></a>
<a name="index-version-control-2"></a>
<a name="index-hibtypes_002dgithub_002ddefault_002dproject"></a>
<a name="index-hibtypes_002dgithub_002ddefault_002duser"></a>
</dd>
<dt><code>github-reference</code></dt>
<dd><p>Display the Github entity associated with REFERENCE and optional USER and PROJECT.
See <samp>../DEMO#Github (Remote) References</samp> for examples.
</p>
<p>REFERENCE is a string of one of the following forms:
</p><ul>
<li> &lt;ref-item&gt;
</li><li> &lt;user&gt;/&lt;project&gt;/&lt;ref-item&gt;
</li><li> &lt;project&gt;/&lt;ref-item&gt;
</li><li> /&lt;project&gt;.
</li></ul>

<p>&lt;ref-item&gt; is one of these:
</p><dl compact="compact">
<dt>&bull; one of the words: branches, commits, issues, pulls, or tags</dt>
<dd><p>the associated items are listed
</p></dd>
<dt>&bull; one of the words: branch, commit, issue, pull or tag followed by a &rsquo;/&rsquo; and item id</dt>
<dd><p>the item is shown
</p></dd>
<dt>&bull; an issue reference given by a positive integer, e.g. <em>92</em> or prefaced with <em>GH-</em>, like GH-92</dt>
<dd><p>the issue is displayed
</p></dd>
<dt>&bull; a commit reference given by a hex number, 55a1f0</dt>
<dd><p>the commit diff is displayed
</p></dd>
<dt>&bull; a branch or tag reference given by an alphanumeric name, e.g. hyper20</dt>
<dd><p>the files in the branch are listed.
</p></dd>
</dl>

<a name="index-hibtypes_002dgithub_002ddefault_002duser-1"></a>
<p>USER defaults to the value of <code>hibtypes-github-default-user</code>.
If given, PROJECT overrides any project value in REFERENCE.  If no
PROJECT value is provided, it defaults to the value of
<code>hibtypes-github-default-project</code>.
</p>
<a name="index-ibtypes-gitlab_002dreference"></a>
<a name="index-gitlab-reference"></a>
<a name="index-version-control-3"></a>
<a name="index-hibtypes_002dgitlab_002ddefault_002dproject"></a>
<a name="index-hibtypes_002dgitlab_002ddefault_002duser"></a>
</dd>
<dt><code>gitlab-reference</code></dt>
<dd><p>Display the Gitlab entity associated with REFERENCE and optional USER and PROJECT.
See <samp>../DEMO#Gitlab (Remote) References</samp> for examples.
</p>
<p>REFERENCE is a string of one of the following forms:
</p><ul>
<li> &lt;ref-item&gt;
</li><li> &lt;user&gt;/&lt;project&gt;/&lt;ref-item&gt;
</li><li> &lt;project&gt;/&lt;ref-item&gt;
</li><li> /&lt;group&gt;/&lt;project&gt;.
or
</li><li> /&lt;project-or-group&gt; (where a group is a colection of projects)
</li></ul>

<p>&lt;ref-item&gt; is one of these:
</p><dl compact="compact">
<dt>&bull; one of the words: activity, analytics, boards or kanban, branches, commits, contributors, groups, issues or list, jobs, labels, merge_requests, milestones, pages, pipelines, pipeline_charts, members or people or staff, projects, pulls, schedules, snippets, status or tags</dt>
<dd><p>the associated items are listed
</p></dd>
<dt>&bull; one of the words: branch, commit(s), issue(s), milestone(s), pull(s), snippet(s) or tag(s) followed by a &rsquo;/&rsquo; or &rsquo;=&rsquo; and an item-id</dt>
<dd><p>the item is shown
</p></dd>
<dt>&bull; an issue reference given by a positive integer, e.g. <em>92</em> or prefaced with <em>GL-</em>, like GL-92</dt>
<dd><p>the issue is displayed
</p></dd>
<dt>&bull; a commit reference given by a hex number, 55a1f0</dt>
<dd><p>the commit diff is displayed
</p></dd>
<dt>&bull; a branch or tag reference given by an alphanumeric name, e.g. hyper20</dt>
<dd><p>the files in the branch are listed.
</p></dd>
</dl>

<a name="index-hibtypes_002dgitlab_002ddefault_002duser-1"></a>
<p>USER defaults to the value of <code>hibtypes-gitlab-default-user</code>.
If given, PROJECT overrides any project value in REFERENCE.  If no
PROJECT value is provided, it defaults to the value of
<code>hibtypes-gitlab-default-project</code>.
</p>
<a name="index-ibtypes-social_002dreference"></a>
<a name="index-hashtag"></a>
<a name="index-username"></a>
<a name="index-social-media"></a>
<a name="index-social-reference"></a>
<a name="index-hibtypes_002dsocial_002ddefault_002dservice"></a>
</dd>
<dt><code>social-reference</code></dt>
<dd><p>Display the web page associated with a social media hashtag or
username reference at point.
</p>
<p>Reference format is:
</p><div class="example">
<pre class="example">[facebook|instagram|twitter]?[#@]&lt;hashtag-or-username&gt; or
[fb|in|tw]?[#@]&lt;hashtag-or-username&gt;
</pre></div>

<p>For example, &lsquo;<samp>fb@someuser</samp>&rsquo; displays the home page for facebook user
&lsquo;<samp>someuser</samp>&rsquo; and &lsquo;<samp>in#hashtag</samp>&rsquo; displays photos with the hashtag
&lsquo;<samp>hashtag</samp>&rsquo;.  The first part of the label for a button of this type
is the social media service name.  The service name defaults to the
value of <code>hibtypes-social-default-service</code> (default value of
&ldquo;twitter&rdquo;) when not given, so #hashtag would be the same as
twitter#hashtag.
</p>
<a name="index-ibtypes-debbugs_002dgnu_002dmode"></a>
<a name="index-bug-tracking"></a>
<a name="index-issue-tracking"></a>
</dd>
<dt><code>debbugs-gnu-mode</code></dt>
<dd><p>Debbugs is a client-server issue tracker used by GNU free software
projects, including Hyperbole, to manage issues and maintain threads
of discussion around them.  You issue queries to a Debbugs server and
it returns a listing entry for each matching issue.  When on a GNU
Debbugs listing entry in <code>debbugs-gnu-mode</code>, an Action Key press
displays the discussion of the selected issue; an Assist Key press
pretty prints the status of the issue to a window below the listing
window.
</p>
<a name="index-ibtypes-debbugs_002dgnu_002dquery"></a>
</dd>
<dt><code>debbugs-gnu-query</code></dt>
<dd><p>Display the results of a Debbugs query based on a bug reference string
around point.  This works in most types of buffers.  If the query
includes a single id number, it displays the original message
submission for that id and allows browsing of the followup discussion.
The following buffer text formats are accepted (with point prior to
any attribute):
</p>
<div class="smallexample">
<pre class="smallexample">bug#id-number, bug# id-number, bug #id-number or bug id-number
bug?attr1=val1&amp;attr2=val2&amp;attr3=val3
bug#id-number?attr1=val1&amp;attr2=val2&amp;attr3=val3
</pre></div>

<a name="index-file_002c-hib_002ddebbugs_002eel"></a>
<p>Note that <em>issue</em> or <em>debbugs</em> may also be used in place
of <em>bug</em>.  See the documentation at the top of
the <samp>hib-debbugs.el</samp> file for detailed query format information.
</p>
<a name="index-ibtypes-annot_002dbib"></a>
<a name="index-bibliography"></a>
<a name="index-reference"></a>
</dd>
<dt><code>annot-bib</code></dt>
<dd><p>Display annotated bibliography entries defined within the same buffer
as the reference.  References must be delimited by square brackets, must
begin with a word constituent character, and must not be in buffers
whose names begin with a &lsquo; &rsquo; or &lsquo;*&rsquo; character.
</p>

<a name="index-ibtypes-function_002din_002dbuffer"></a>
<a name="index-file_002c-func_002dmenu_002eel"></a>
<a name="index-function-menu"></a>
<a name="index-func_002dmenu"></a>
</dd>
<dt><code>function-in-buffer</code></dt>
<dd><p>Return the function name defined within this buffer that point is
within or after, else <code>nil</code>.  This triggers only when the
func-menu library has been loaded and the current major mode is one
handled by func-menu.
</p>
<a name="index-link_002c-pathname-line-and-column"></a>
<a name="index-line-and-column"></a>
<a name="index-pathname_002c-line-and-column"></a>
<a name="index-ibtypes-pathname_002dline_002dand_002dcolumn"></a>
</dd>
<dt><code>pathname-line-and-column</code></dt>
<dd><p>Make a valid <samp>pathname:line-num[:column-num]</samp> pattern display the
path at <em>line-num</em> and optional <em>column-num</em>.  Also works
for remote pathnames.  May also contain hash-style link references
with the following format: <samp>&lt;path&gt;[#&lt;link-anchor&gt;]:&lt;line-num&gt;[:&lt;column-num&gt;]</samp>.
</p>
<a name="index-ibtypes-pathname"></a>
<a name="index-hpath_003aat_002dp"></a>
<a name="index-hpath_003afind"></a>
<a name="index-hpath_003asuffixes"></a>
<a name="index-Tramp"></a>
<a name="index-ftp-1"></a>
<a name="index-pathname"></a>
<a name="index-remote-path"></a>
<a name="index-filename"></a>
<a name="index-link_002c-pathname"></a>
<a name="index-environment-variables"></a>
<a name="index-Emacs-Lisp-variables"></a>
<a name="index-Lisp-variables"></a>
</dd>
<dt><code>pathname</code></dt>
<dd><p>Make a valid pathname display the path entry.  Also works for
delimited and non-delimited remote pathnames, Texinfo @file{}
entries, and hash-style link references to HTML, XML, SGML, Markdown
or Emacs outline headings, shell script comments, and MSWindows paths
(see <samp>${hyperb:dir}/DEMO#POSIX and MSWindows Paths</samp> for
details).  Emacs Lisp library files (filenames without any directory
component that end in .el and .elc) are located using
the <code>load-path</code> directory list.
</p>
<p>The pathname may contain references to Emacs Lisp variables or shell
environment variables using the syntax, \&quot;${variable-name}\&quot;.
See <a href="#Link-Variable-Substitution">Link Variable Substitution</a>, for how this handled.
</p>
<p>See the function documentation for <code>hpath:at-p</code> for possible
delimiters.  See the variable documentation for <code>hpath:suffixes</code> for
suffixes that are added to or removed from the pathname when searching
for a valid match.  See the function documentation for <code>hpath:find</code>
for special file display options.
</p>
<a name="index-ibtypes-www_002durl"></a>
<a name="index-URL"></a>
<a name="index-World_002dwide-Web"></a>
<a name="index-WWW"></a>
<a name="index-Action-Key_002c-web-browsing"></a>
<a name="index-Action-Key_002c-web-browsing-1"></a>
<a name="index-browse_002durl_002dbrowser_002dfunction"></a>
</dd>
<dt><code>www-url</code></dt>
<dd><p>When not in an Emacs web browser buffer, follow any non-ftp URL (link) at point.
The variable, <code>browse-url-browser-function</code>, may be used to customize
which URL browser is called.  Terse URLs which lack a protocol prefix,
like www.gnu.org, are also recognized.
</p>
<a name="index-ibtypes-org_002dmode"></a>
<a name="index-Org_002dmode"></a>
<a name="index-radio-target"></a>
<a name="index-code-block"></a>
<a name="index-links"></a>
<a name="index-C_002dc-C_002dc"></a>
<a name="index-M_002dRET-1"></a>
<a name="index-org_002dctrl_002dc_002dctrl_002dc"></a>
<a name="index-org_002dmeta_002dreturn"></a>
<a name="index-inhibit_002dhsys_002dorg"></a>
<a name="index-disable-org_002dmode-support"></a>
<a name="index-inhibit-org_002dmode-support"></a>
</dd>
<dt><code>org-mode</code></dt>
<dd><p>For users of Emacs Org-mode, Hyperbole does quite a few things.
</p>
<p>First, the Action Key follows internal links in Org-mode files.  When
pressed on a link referent/target, the link definition is displayed,
allowing two-way navigation between definitions and targets.
</p>
<p>Second, the Action Key follows Org-mode external links.  The Assist
Key displays help when pressed on an Org-mode link.
</p>
<p>Third, within a radio target definition, the Action Key jumps to the
first occurrence of an associated radio target.
</p>
<p>Fourth, when point is on an outline heading in Org-mode, the Action Key
cycles the view of the subtree at point and the Assist Key cycles the
view of all headings in the buffer.
</p>
<p>Fifth, with point on the first line of a code block definition, the
Action Key executes the code block via the Org-mode standard binding
of <kbd>{C-c C-c}</kbd>, <code>org-ctrl-c-ctrl-c</code>.
</p>
<p>In any other context besides the end of a line, the Action Key invokes
the Org-mode standard binding of <kbd>{M-<span class="key">RET</span>}</kbd>, <code>org-meta-return</code>.
</p>
<p>To disable ALL Hyperbole support within Org major and minor modes, set
the custom option <code>inhibit-hsys-org</code> to <code>t</code>.  Then in Org modes,
the Action Key will simply invoke <code>org-meta-return</code>.
</p>
</dd>
</dl>


<hr>
<a name="Action-Buttons"></a>
<div class="header">
<p>
Previous: <a href="#Implicit-Button-Types" accesskey="p" rel="prev">Implicit Button Types</a>, Up: <a href="#Implicit-Buttons" accesskey="u" rel="up">Implicit Buttons</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Action-Buttons-1"></a>
<h4 class="subsection">3.3.2 Action Buttons</h4>

<a name="index-action-button"></a>
<a name="index-implicit-action-button"></a>
<p>Explicit buttons all use the same syntax and store their action data
in a file separate from the button source file.  Implicit buttons have
no external data but use a unique syntax per implicit button type to
recognize the action to run.
</p>
<p>For times when you need a cross between the two, with a universal
button syntax and all button data stored in the button source file,
there are <em>action buttons</em>.
</p>
<p><em>Action Buttons</em> are a form of implicit buttons that can execute
any existing action types or Emacs Lisp functions.  Such buttons are
delimited by angle brackets, &lt; &gt;, and come in three types:
</p>
<dl compact="compact">
<dt><em>action type invocations</em></dt>
<dd><p>These begin with an action type name (from the list displayed by
<kbd>{C-h h d t a <span class="key">RET</span>}</kbd>) and are followed by any needed arguments
to form the action, e.g.
</p><div class="example">
<pre class="example">&lt;link-to-file-line &quot;${hyperb:dir}/hact.el&quot; 40&gt;
</pre></div>

</dd>
<dt><em>function calls</em></dt>
<dd><p>These are similar to action type invocations but begin with an Emacs
Lisp function name rather than an action type name, e.g.
</p>
<div class="example">
<pre class="example">&lt;find-file-other-window &quot;/tmp&quot;&gt;
</pre></div>

<p>Generally, such functions are invoked for their side-effects and their
return value is silently ignored.  But if a function is a boolean
predicate whose name ends in &lsquo;<samp>-p</samp>&rsquo;, then the result is displayed
in the minibuffer.
</p>
</dd>
<dt><em>variable displays</em></dt>
<dd><p>These consist of an Emacs Lisp variable name only.  They display
messages with their variable name and value, e.g.
</p>
<div class="example">
<pre class="example">&lt;fill-column&gt;
</pre></div>

<p>If there is a function binding with the same name as the variable you
wish to display, to prevent interpretation as a function call
action button, precede the name with a <code>$</code>, e.g.
</p>
<div class="example">
<pre class="example">&lt;$fill-column&gt;
</pre></div>

</dd>
</dl>

<p>With action buttons you need not remember any special syntax for each
type of implicit button.  You can freely embed them in any type of
text and use the Action and Assist keys on them as you do with any
other type of implicit button.
</p>
<p>An action button is recognized only if the first name within the angle
brackets is an existing action type or Emacs Lisp symbol.  Otherwise,
other implicit button types will be tested and may activate instead.
</p>
<p>To activate a frequently used action button by name independent of
your current buffer, simply add it to your global button file and
precede it with a label <kbd>{C-h h i l}</kbd>.  Then invoke it by label
name with: <kbd>{C-h h g a}</kbd>.
</p>

<hr>
<a name="Button-Files"></a>
<div class="header">
<p>
Next: <a href="#Action-Types" accesskey="n" rel="next">Action Types</a>, Previous: <a href="#Implicit-Buttons" accesskey="p" rel="prev">Implicit Buttons</a>, Up: <a href="#Buttons" accesskey="u" rel="up">Buttons</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Button-Files-1"></a>
<h3 class="section">3.4 Button Files</h3>

<a name="index-button-files"></a>
<p>It is often convenient to create files filled with buttons as a means
of navigating distributed information pools or for other purposes.
These files can also serve as useful roadmaps that guide a user
through both unfamiliar and highly familiar information spaces.  Files
that are created specifically for this purpose are
called <em>Hyperbole button files</em>.
</p>
<a name="index-hbmap_003afilename"></a>
<a name="index-button-file_002c-personal"></a>
<a name="index-button-file_002c-directory"></a>
<p>The Hyperbole menu system provides quick access to two types of these
button files: personal and directory-specific, through the ButFile menu.
(The variable, <code>hbmap:filename</code>, contains the base name of these
button files.  Its standard value is <samp>HYPB</samp>.)
</p>
<a name="index-dir_002c-_007e_002f_002ehyperb"></a>
<a name="index-hbmap_003adir_002duser"></a>
<a name="index-global-button-2"></a>
<p>A personal button file may serve as a user&rsquo;s own roadmap to frequently
used resources, like a personal home page.  Selection of the
ButFile/PersonalFile menu item, <kbd>{C-h h b p}</kbd>, displays this file for
editing.  The default personal button file is stored within the
directory given by the <code>hbmap:dir-user</code> variable whose standard
value is <samp>~/.hyperb</samp>.  The default Hyperbole configuration also
appends all global buttons to the end of this file, one per line, as
they are created.  So you can edit or annotate them within the file.
</p>
<p>A directory-specific button file may exist for each file system
directory.  Such files are useful for explaining the contents of
directories and pointing readers to particular highlights within the
directories.  Selection of the ButFile/DirFile menu item, <kbd>{C-h h
b d}</kbd>, displays the button file for the current directory; this
provides an easy means of updating this file when working on a file
within the same directory.  If you want to view some other
directory-specific button file, simply use the normal Emacs file
finding commands.
</p>
<p>If you want group and site-specific button files, simply place links to such
files at the top of your personal button file and do so for your colleagues.
This provides a flexible means of connecting to such resources.
</p>
<hr>
<a name="Action-Types"></a>
<div class="header">
<p>
Next: <a href="#Button-Type-Precedence" accesskey="n" rel="next">Button Type Precedence</a>, Previous: <a href="#Button-Files" accesskey="p" rel="prev">Button Files</a>, Up: <a href="#Buttons" accesskey="u" rel="up">Buttons</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Action-Types-1"></a>
<h3 class="section">3.5 Action Types</h3>

<a name="index-action-type"></a>
<a name="index-argument_002c-use"></a>
<a name="index-action"></a>
<a name="index-button-action"></a>
<p><em>Action types</em> are special functions that specify Hyperbole button
behaviors.  Each action type may be used by any category of button:
global, explicit, or implicit.  The arguments needed by an action type
are prompted for at button creation time or in the case of an implicit
button, computed when the button is activated.  During button
activation, the arguments are fed to the action type&rsquo;s body to achieve
the desired result.  This body is called the button <em>action</em>.
</p>
<p>Hyperbole handles all of this processing transparently.  As a user, all
you need know is the set of action types that you can work with when
creating explicit or global buttons.
</p>
<a name="index-actypes_002c-list-of"></a>
<p>The standard action types included with Hyperbole in alphabetical order
are:
</p>
<dl compact="compact">
<dd><a name="index-actypes-annot_002dbib"></a>
</dd>
<dt><code>annot-bib</code></dt>
<dd><p>Follow an internal reference KEY within an annotated bibliography,
delimiters = [ ].
</p>
<a name="index-actypes-completion"></a>
</dd>
<dt><code>completion</code></dt>
<dd><p>Insert a completion at point into the minibuffer or a buffer.
Unless point is at the end of buffer or if a completion has already been 
inserted, in which case, delete the completions window.
</p>
<a name="index-actypes-display_002dvariable"></a>
</dd>
<dt><code>display-variable-value</code></dt>
<dd><p>Display a message showing the given variable name and its value.
</p>
<a name="index-actypes-eval_002delisp"></a>
</dd>
<dt><code>eval-elisp</code></dt>
<dd><p>Evaluate a Lisp expression LISP-EXPR for its side-effects and return any non-nil value.
</p>
<a name="index-actypes-exec_002dkbd_002dmacro"></a>
</dd>
<dt><code>exec-kbd-macro</code></dt>
<dd><p>Execute a KBD-MACRO REPEAT-COUNT times.  KBD-MACRO may be a string of
editor command characters, a function symbol or nil to use the last
defined keyboard macro.  Optional REPEAT-COUNT nil means execute once,
zero means repeat until error.
</p>
<a name="index-actypes-exec_002dshell_002dcmd"></a>
</dd>
<dt><code>exec-shell-cmd</code></dt>
<dd><p>Execute a SHELL-CMD string asynchronously.  Optional non-nil second
argument INTERNAL-CMD inhibits display of the shell command line
executed.  Optional non-nil third argument KILL-PREV means kill the last
output to the shell buffer before executing SHELL-CMD.
</p>
<a name="index-actypes-exec_002dwindow_002dcmd"></a>
</dd>
<dt><code>exec-window-cmd</code></dt>
<dd><p>Asynchronously execute an external window-based SHELL-CMD string.
</p>
<a name="index-actypes-function_002din_002dbuffer"></a>
</dd>
<dt><code>function-in-buffer</code></dt>
<dd><p>Display the definition of function NAME found at POS in the current buffer.
</p>
<a name="index-actypes-hyp_002dconfig"></a>
</dd>
<dt><code>hyp-config</code></dt>
<dd><p>Insert Hyperbole configuration and debugging information at the end
of the current buffer or within optional OUT-BUF.
</p>
<a name="index-actypes-hyp_002drequest"></a>
</dd>
<dt><code>hyp-request</code></dt>
<dd><p>Insert help for composing a Hyperbole support/discussion message into
the current buffer or the optional OUT-BUF.
</p>
<a name="index-actypes-hyp_002dsource"></a>
</dd>
<dt><code>hyp-source</code></dt>
<dd><p>Display a buffer or file from a line beginning with <code>hbut:source-prefix</code>.
</p>
<a name="index-actypes-kbd_002dkey"></a>
</dd>
<dt><code>kbd-key</code></dt>
<dd><p>Execute the function binding for KEY-SEQUENCE, delimited by {}.
Return &lsquo;<samp>t</samp>&rsquo; if a KEY-SEQUENCE has a binding, else &lsquo;<samp>nil</samp>&rsquo;.
</p>
<a name="index-link-action-types"></a>
<a name="index-actypes-link_002dto_002dbookmark"></a>
</dd>
<dt><code>link-to-bookmark</code></dt>
<dd><p>Display an Emacs BOOKMARK.
When creating the button, if in Bookmark Menu mode, use the bookmark
nearest point as the default.  Otherwise, utilize the most recently used
bookmark in the current file (bookmark-current-bookmark) as the default,
if any.
</p>
<a name="index-actypes-link_002dto_002dbuffer_002dtmp"></a>
</dd>
<dt><code>link-to-buffer-tmp</code></dt>
<dd><p>Display a BUFFER.  This type of link is for use in  a single editor session.
Use <code>link-to-file</code> instead for a permanent link.
</p>
<a name="index-actypes-link_002dto_002ddirectory"></a>
</dd>
<dt><code>link-to-directory</code></dt>
<dd><p>Display a DIRECTORY in Dired mode.
</p>
<a name="index-actypes-link_002dto_002ddoc"></a>
</dd>
<dt><code>link-to-doc</code></dt>
<dd><p>Display an online version of a document given by DOC-ID.  If the online
version of a document is not found in <code>doc-id-indices</code>, signal an error.
</p>
<a name="index-actypes-link_002dto_002debut"></a>
</dd>
<dt><code>link-to-ebut</code></dt>
<dd><p>Perform an action given by an explicit button, specified by KEY and KEY-FILE.
</p>
<a name="index-actypes-link_002dto_002delisp_002ddoc"></a>
</dd>
<dt><code>link-to-elisp-doc</code></dt>
<dd><p>Display the documentation for FUNC-SYMBOL.
</p>
<a name="index-actypes-link_002dto_002dfile"></a>
</dd>
<dt><code>link-to-file</code></dt>
<dd><p>Display a file given by PATH scrolled to optional POINT.  If POINT is given,
display the buffer with POINT at the top of the window.
</p>
<a name="index-actypes-link_002dto_002dfile_002dline"></a>
</dd>
<dt><code>link-to-file-line</code></dt>
<dd><p>Display a file given by PATH scrolled to LINE-NUM.
</p>
<a name="index-actypes-link_002dto_002dgbut"></a>
</dd>
<dt><code>link-to-gbut</code></dt>
<dd><p>Perform an action given by an existing global button, specified by KEY.
</p>
<a name="index-actypes-link_002dto_002dInfo_002dindex_002ditem"></a>
</dd>
<dt><code>link-to-Info-index-item</code></dt>
<dd><p>Display an Info index ITEM cross-reference.
ITEM must be a string of the form (filename)item-name.  During
button creation, completion for both filename and item-name is
available.  Filename may be given without the .info suffix.&quot;
</p>
<a name="index-actypes-link_002dto_002dInfo_002dnode"></a>
</dd>
<dt><code>link-to-Info-node</code></dt>
<dd><p>Display an Info NODE.  NODE must be a string of the form
(filename)nodename.  During button creation, completion for both
filename and nodename is available.  Filename may be given without the
.info suffix.
</p>
<a name="index-actypes-link_002dto_002dibut"></a>
</dd>
<dt><code>link-to-ibut</code></dt>
<dd><p>Perform an action given by an implicit button, specified by KEY, optional KEY-FILE and POINT.
</p>
<a name="index-actypes-link_002dto_002dkcell"></a>
<a name="index-kcell_003aref_002dto_002did"></a>
</dd>
<dt><code>link-to-kcell</code></dt>
<dd><p>Display a Hyperbole outline cell, given by FILE and CELL-REF, at the
top of a window.  See the documentation for <code>(kcell:ref-to-id)</code> for
valid CELL-REF formats.
</p>
<p>If FILE is &lsquo;<samp>nil</samp>&rsquo;, use the current buffer.  If CELL-REF is
&lsquo;<samp>nil</samp>&rsquo;, show the first cell in the view.
</p>
<a name="index-actypes-link_002dto_002dkotl"></a>
</dd>
<dt><code>link-to-kotl</code></dt>
<dd><p>Display at the top of a window the referent pointed to by LINK.
LINK may be of any of the following forms, with or without delimiters:
</p><div class="example">
<pre class="example">  &lt; pathname [, cell-ref] &gt;
  &lt; [-!&amp;] pathname &gt;
  &lt; @ cell-ref &gt;
</pre></div>

<p>See the documentation for <code>(kcell:ref-to-id)</code> for valid cell-ref
formats.
</p>
<a name="index-actypes-link_002dto_002dmail"></a>
</dd>
<dt><code>link-to-mail</code></dt>
<dd><p>Display a mail message with MAIL-MSG-ID from optional MAIL-FILE.  See
the documentation for the variable <code>hmail:init-function</code> for
information on how to specify the mail reader to use.
</p>
<a name="index-actypes-link_002dto_002dregexp_002dmatch"></a>
</dd>
<dt><code>link-to-regexp-match</code></dt>
<dd><p>Find REGEXP&rsquo;s Nth occurrence in SOURCE and display the location at the
top of the selected window.  SOURCE is a pathname unless optional
BUFFER-P is non-nil, then SOURCE must be a buffer name or buffer.
Return &lsquo;<samp>t</samp>&rsquo; if found, signal an error if not.
</p>
<a name="index-actypes-link_002dto_002drfc"></a>
</dd>
<dt><code>link-to-rfc</code></dt>
<dd><p>Retrieve and display an Internet rfc given by RFC-NUM.  RFC-NUM may be
a string or an integer.
</p>
<a name="index-actypes-link_002dto_002dstring_002dmatch"></a>
</dd>
<dt><code>link-to-string-match</code></dt>
<dd><p>Find STRING&rsquo;s Nth occurrence in SOURCE and display the location at the
top of the selected window.  SOURCE is a pathname unless optional
BUFFER-P is non-nil, then SOURCE must be a buffer name or buffer.
Return &lsquo;<samp>t</samp>&rsquo; if found, &lsquo;<samp>nil</samp>&rsquo; if not.
</p>
<a name="index-actypes-link_002dto_002dtexinfo_002dnode"></a>
</dd>
<dt><code>link-to-texinfo-node</code></dt>
<dd><p>Display the Texinfo node with NODENAME (a string) from the current buffer.
</p>
<a name="index-actypes-link_002dto_002dweb_002dsearch"></a>
<a name="index-link_002c-web-search"></a>
<a name="index-web-search-link"></a>
</dd>
<dt><code>link-to-web-search</code></dt>
<dd><p>Search web SERVICE-NAME for SEARCH-TERM.  Uses <code>hyperbole-web-search-alist</code>
to match each service to its search url.  Uses <code>hyperbole-web-search-browser-function</code>
and the <code>browse-url</code> package to display search results.
</p>
<a name="index-actypes-man_002dshow"></a>
<a name="index-hpath_003adisplay_002dwhere"></a>
<a name="index-man-page"></a>
</dd>
<dt><code>man-show</code></dt>
<dd><p>Display a man page on TOPIC, which may be of the form &lsquo;<samp>&lt;command&gt;(&lt;section&gt;</samp>&rsquo;).
Use <code>hpath:display-where</code> setting to control where the man page is displayed.
</p>
<a name="index-actypes-rfc_002dtoc"></a>
</dd>
<dt><code>rfc-toc</code></dt>
<dd><p>Compute and display a summary of an Internet rfc in BUF-NAME.  Assume
point has already been moved to the start of the region to summarize.
Optional OPOINT is the point to return to in BUF-NAME after displaying
the summary.
</p>
<a name="index-actypes-text_002dtoc"></a>
<a name="index-table-of-contents-2"></a>
<a name="index-toc-action-type"></a>
</dd>
<dt><code>text-toc</code></dt>
<dd><p>Jump to the text file SECTION referenced by a table of contents entry at point.
</p>
<a name="index-actypes-www_002durl"></a>
<a name="index-URL-1"></a>
<a name="index-World_002dwide-Web-1"></a>
<a name="index-WWW-1"></a>
<a name="index-browse_002durl_002dbrowser_002dfunction-1"></a>
</dd>
<dt><code>www-url</code></dt>
<dd><p>Follow a link given by a URL.  The variable,
<code>browse-url-browser-function</code>, customizes the url browser
that is used.  Valid values of this variable include
<code>browse-url-default-browser</code> and <code>browse-url-generic</code>.
See its documentation string for details.
</p></dd>
</dl>


<a name="index-action-1"></a>
<a name="index-hui_003aebut_002dprompt_002dfor_002daction"></a>
<p>Action types create a convenient way of specifying button behavior
without the need to know how to program.  Expert users who are familiar
with Emacs Lisp, however, may find that they often want to tailor button
actions in a variety of ways not easily captured within a type system.
In such cases, <code>hui:ebut-prompt-for-action</code> should be set to
&lsquo;<samp>t</samp>&rsquo;.  This will cause Hyperbole to prompt for an action to override
the button&rsquo;s action type at each explicit button creation.  For those cases
where the action type is sufficient, a &lsquo;<samp>nil</samp>&rsquo; value should be
entered for the action.  An action may be any Lisp form that Emacs
Lisp can evaluate.
</p>
<hr>
<a name="Button-Type-Precedence"></a>
<div class="header">
<p>
Next: <a href="#Utilizing-Explicit-Buttons" accesskey="n" rel="next">Utilizing Explicit Buttons</a>, Previous: <a href="#Action-Types" accesskey="p" rel="prev">Action Types</a>, Up: <a href="#Buttons" accesskey="u" rel="up">Buttons</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Button-Type-Precedence-1"></a>
<h3 class="section">3.6 Button Type Precedence</h3>

<a name="index-button-precedence"></a>
<a name="index-precedence_002c-buttons"></a>
<a name="index-button-label-overlap"></a>
<p>Explicit buttons always take precedence over implicit buttons.  Thus, if
a button selection is made which falls within both an explicit and
implicit button, only the explicit button will be selected.  Explicit
button labels are not allowed to overlap; Hyperbole&rsquo;s behavior in such
cases is undefined.
</p>
<a name="index-ibtype_002c-evaluation-order"></a>
<p>If there is no explicit button at point during a selection request,
then each implicit button type predicate is tested in turn until one
returns non-nil or all are exhausted.  Since two implicit button types
may have overlapping <em>domains</em>, those contexts in which their
predicates are true, only the first matching type is used.  The type
predicates are tested in <em>reverse</em> order of definition, i.e.
most recently entered types are tested first, so that personal types
defined after standard system types take precedence.  It is important
to keep this order in mind when defining new implicit button types.
By making match predicates as specific as possible, one can minimize
any overlapping implicit button domains.
</p>
<a name="index-type-redefinition"></a>
<p>Once a type name is defined, its precedence relative to other types
remains the same even if its body is redefined, as long as its name is
not changed.  This allows incremental modifications to types without
any worry of altering their precedences.  See <a href="#Creating-Types">Creating Types</a>, for
information on how to develop or modify types.
</p>
<hr>
<a name="Utilizing-Explicit-Buttons"></a>
<div class="header">
<p>
Previous: <a href="#Button-Type-Precedence" accesskey="p" rel="prev">Button Type Precedence</a>, Up: <a href="#Buttons" accesskey="u" rel="up">Buttons</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Utilizing-Explicit-Buttons-1"></a>
<h3 class="section">3.7 Utilizing Explicit Buttons</h3>

<p>Explicit buttons are a fundamental building block for creating personal
or organizational hypertext networks with Hyperbole.  This section
summarizes the user-level operations available for managing these
buttons.
</p>
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">&bull; <a href="#Creation" accesskey="1">Creation</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Renaming" accesskey="2">Renaming</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Deletion" accesskey="3">Deletion</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Modification" accesskey="4">Modification</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Searching-and-Summarizing" accesskey="5">Searching and Summarizing</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Buttons-in-Mail" accesskey="6">Buttons in Mail</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Buttons-in-News" accesskey="7">Buttons in News</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
</table>

<hr>
<a name="Creation"></a>
<div class="header">
<p>
Next: <a href="#Renaming" accesskey="n" rel="next">Renaming</a>, Previous: <a href="#Utilizing-Explicit-Buttons" accesskey="p" rel="prev">Utilizing Explicit Buttons</a>, Up: <a href="#Utilizing-Explicit-Buttons" accesskey="u" rel="up">Utilizing Explicit Buttons</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Creation-1"></a>
<h4 class="subsection">3.7.1 Creation</h4>

<p>Creating explicit buttons is fun and easy.  You can always try them
out immediately after creating them or can utilize the Assist Key to
verify what buttons do.  There are two ways to create them: by
dragging between windows with the Action Mouse Key or by using the
Hyperbole menus.
</p>
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">&bull; <a href="#By-Dragging" accesskey="1">By Dragging</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Creation Via Action Key Drags
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#By-Menu" accesskey="2">By Menu</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">Creation Via Menus
</td></tr>
</table>

<hr>
<a name="By-Dragging"></a>
<div class="header">
<p>
Next: <a href="#By-Menu" accesskey="n" rel="next">By Menu</a>, Previous: <a href="#Creation" accesskey="p" rel="prev">Creation</a>, Up: <a href="#Creation" accesskey="u" rel="up">Creation</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Creation-Via-Action-Key-Drags"></a>
<h4 class="subsubsection">3.7.1.1 Creation Via Action Key Drags</h4>

<a name="index-explicit-button-creation"></a>
<a name="index-button-creation"></a>
<a name="index-creating-buttons"></a>
<a name="index-link-creation"></a>
<a name="index-creating-links"></a>
<a name="index-direct-link-creation"></a>
<a name="index-mouse-drag_002c-link-creation"></a>
<a name="index-drag"></a>
<a name="index-Action-Key-drag"></a>
<p>The most efficient way to create an explicit link button interactively
is to use the Action Mouse Key to drag from a non-read-only button
source window to a window showing its desired link referent.  More
specifically, you should split your current Emacs frame into two
windows: one which contains the point at which you want a button to be
inserted and another which shows the point to which you want to link.
Depress the Action Mouse Key at the source point for the button
(anywhere but on a paired delimiter such as double quotes or
parentheses).  Then drag to the other window and release the Action
Mouse Key at the start point of the link referent.  The process
becomes quite simple with a little practice. (See <a href="#By-Menu">Creation
Via Menus</a>, for a more detailed explanation of the explicit button
creation process).
</p>
<p>If a region was selected prior to the start of the drag, it is used as
the button label, otherwise, you are prompted for the label.  Then
Hyperbole uses the link referent context to determine the type of link
to make.  If there are a few different types of links which are
applicable from the context, you will be prompted with a list of the
types.  Simply use the Action Key or the first letter of the link type
to select one of the type names and to finish the link creation.
Hyperbole will then insert explicit button delimiters around the
button label and will display a message in the minibuffer indicating
the button label, its action/link type, and any arguments, notably the
thing to which it links.
</p>
<p>The following table shows the type of link that will be created based
upon the referent context in which the Action Key is released.
</p>
<div class="format">
<div class="example">
<pre class="example">Referent Context         Link Type
----------------------------------------------------
Global Button            link-to-gbut
Explicit Button          link-to-ebut
Implicit Button          link-to-ibut
Bookmarks List           link-to-bookmark
Info Index Item          link-to-Info-index-item
Info Node                link-to-Info-node
Texinfo Node             link-to-texinfo-node
Mail Reader Message      link-to-mail
Directory Name           link-to-directory
Filename                 link-to-file
Koutline Cell            link-to-kcell
Outline Heading          link-to-string-match
Buffer attached to File  link-to-file
Buffer without File      link-to-buffer-tmp
</pre></div>
</div>


<hr>
<a name="By-Menu"></a>
<div class="header">
<p>
Previous: <a href="#By-Dragging" accesskey="p" rel="prev">By Dragging</a>, Up: <a href="#Creation" accesskey="u" rel="up">Creation</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Creation-Via-Menus"></a>
<h4 class="subsubsection">3.7.1.2 Creation Via Menus</h4>

<p>You may instead use the Hyperbole menus to create explicit buttons.
First, mark a short region of text in any fashion allowed by Emacs
and then select the Hyperbole menu item sequence, Ebut/Create.  You will
be prompted for the button&rsquo;s label with the marked region as the
default.  If you accept the default and enter the rest of the
information you are prompted for, the button will be created within the
current buffer and Hyperbole will surround the marked region with
explicit button delimiters to indicate success.
</p>
<p>If you do not mark a region before invoking the button create command,
you will be prompted for both a label and a target buffer for the button
and the delimited label text will be inserted into the target buffer
after a successful button creation.
</p>
<p>After Hyperbole has the button label and its target buffer, it will
prompt you for an action type for the button.  Use the <kbd>{?}</kbd>
completion list key to see the available types.  The type selected
determines any following values for which you are prompted.
</p>
<a name="index-button-instance"></a>
<a name="index-instance-number"></a>
<p>If a previous button with the same label exists in the same buffer,
Hyperbole will add an <em>instance number</em> to the label when it adds
the delimiters so that the name is unique.  Thus, you don&rsquo;t have to
worry about accidental button name conflicts.  If you want the same
button to appear in multiple places within the buffer, just enter the
label again and delimit it yourself or copy and paste the button with
its delimiters.  Hyperbole will interpret all occurrences of the same
delimited label within a buffer as the same button.
</p>
<a name="index-link_002c-creation"></a>
<p>If you create link buttons using the Hyperbole menus, the best
technique is to place on screen both the source buffer for the button
and the buffer to which it will link.  Mark the region of text to use
as your button label, invoke the button create command from the menu,
choose an action type which begins with <code>link-to-</code> and then use
the direct selection techniques mentioned in <a href="#Smart-Key-Argument-Selection">Smart Key Argument Selection</a>, to select the link referent.
</p>

<hr>
<a name="Renaming"></a>
<div class="header">
<p>
Next: <a href="#Deletion" accesskey="n" rel="next">Deletion</a>, Previous: <a href="#Creation" accesskey="p" rel="prev">Creation</a>, Up: <a href="#Utilizing-Explicit-Buttons" accesskey="u" rel="up">Utilizing Explicit Buttons</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Renaming-1"></a>
<h4 class="subsection">3.7.2 Renaming</h4>

<a name="index-explicit-button-renaming"></a>
<a name="index-button-renaming"></a>
<p>Once an explicit button has been created, its label text must be
treated specially.  Any inter-word spacing within the label may be
freely changed, as may happen when a paragraph is refilled, but a
special command must be invoked to rename it.
</p>
<p>The rename command operates in two different ways.  If point is within
a button label when it is invoked, it will tell you to edit the button
label and then to invoke the rename command again after the edit.  The
second invocation will actually rename the button.  If instead the
command is originally invoked outside of any explicit button, it will
prompt for the button label to replace and the label to replace it
with and then will perform the renaming.  All occurrences of the same
button in the buffer will be renamed.
</p>
<a name="index-file_002c-_002eemacs-1"></a>
<a name="index-file_002c-hyperbole_002eel"></a>
<a name="index-hui_003aebut_002drename"></a>
<p>The rename command may be invoked from the Hyperbole menu via
Ebut/Rename.  Hyperbole does not bind this command to a key by default.
<kbd>{C-h w hui:ebut-rename <span class="key">RET</span>}</kbd> will show what if any key is bound
within your Emacs.  Bind it within your <samp>~/.emacs</samp> file with:
<code>(global-set-key &quot;\C-cr&quot; 'hui:ebut-rename)</code>, for example.
</p>

<hr>
<a name="Deletion"></a>
<div class="header">
<p>
Next: <a href="#Modification" accesskey="n" rel="next">Modification</a>, Previous: <a href="#Renaming" accesskey="p" rel="prev">Renaming</a>, Up: <a href="#Utilizing-Explicit-Buttons" accesskey="u" rel="up">Utilizing Explicit Buttons</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Deletion-1"></a>
<h4 class="subsection">3.7.3 Deletion</h4>

<a name="index-explicit-button-deletion"></a>
<a name="index-button-deletion"></a>
<p>Ebut/Delete works similarly to the Rename command but deletes the
selected button.  The button&rsquo;s delimiters are removed to confirm the
deletion.  If the delete command is invoked with a prefix argument, then
both the button label and the delimiters are removed as confirmation.
</p>
<a name="index-hui_003ahbut_002ddelete_002dconfirm_002dflag"></a>
<p>Presently there is no way to recover a deleted button; it must
be recreated.  Therefore, the <code>hui:hbut-delete-confirm-flag</code> variable
is true by default, causing Hyperbole to require confirmation before
interactively deleting explicit buttons.  Set it to &lsquo;<samp>nil</samp>&rsquo; if you
prefer no confirmation.
</p>
<hr>
<a name="Modification"></a>
<div class="header">
<p>
Next: <a href="#Searching-and-Summarizing" accesskey="n" rel="next">Searching and Summarizing</a>, Previous: <a href="#Deletion" accesskey="p" rel="prev">Deletion</a>, Up: <a href="#Utilizing-Explicit-Buttons" accesskey="u" rel="up">Utilizing Explicit Buttons</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Modification-1"></a>
<h4 class="subsection">3.7.4 Modification</h4>

<a name="index-explicit-button-modification"></a>
<a name="index-button-modification"></a>
<a name="index-Smart-Mouse-Key-drag"></a>
<a name="index-button-attributes"></a>
<p>Ebut/Modify prompts you with each of the elements from the button&rsquo;s
attributes list and allows you to modify each in turn.  Ebut/Edit does
the exact same thing and is there for people who prefer that term.
</p>
<p>There is a quicker way to modify explicit link buttons, however.  Simply
drag with the Action Mouse Key from within the button label to a link
destination in a different window, just as you would when creating a new
button with a mouse drag.  Remember that drags may also be emulated from
the keyboard.  See <a href="#Creation">Creation</a>.
</p>
<hr>
<a name="Searching-and-Summarizing"></a>
<div class="header">
<p>
Next: <a href="#Buttons-in-Mail" accesskey="n" rel="next">Buttons in Mail</a>, Previous: <a href="#Modification" accesskey="p" rel="prev">Modification</a>, Up: <a href="#Utilizing-Explicit-Buttons" accesskey="u" rel="up">Utilizing Explicit Buttons</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Searching-and-Summarizing-1"></a>
<h4 class="subsection">3.7.5 Searching and Summarizing</h4>

<a name="index-explicit-button-summary"></a>
<a name="index-button-summary"></a>
<a name="index-button-help-1"></a>
<p>The Ebut/Help menu may be used to summarize either a single explicit
button or all such buttons within a buffer.  The buttons summarized may
then be activated directly from the summary.
</p>
<p>Ebut/Help/BufferButs summarizes the explicit buttons in the order in
which they appear in the buffer.  Ebut/Help/CurrentBut summarizes only
the button at point.  Ebut/Help/OrderedButs summarizes the buttons in
alphabetical order.  All of these summary commands eliminate duplicate
occurrences of buttons from their help displays.
</p>
<a name="index-explicit-button-searching"></a>
<a name="index-button-searching"></a>
<p>Ebut/Search prompts for a search pattern and searches across all the
locations in which you have previously created explicit buttons.  It
asks you whether to match to any part of a button label or to whole
labels only.  It then displays a list of button matches with a single
line of surrounding context from their sources.  Any button in the match
list may be activated as usual.  An Action Key press on the surrounding
context jumps to the associated source line.  A press on the filename
preceding the matches jumps to the file without selecting a particular
line.
</p>
<p>There are presently no user-level facilities for globally locating
buttons created by others or for searching on particular button
attributes.
</p>
<hr>
<a name="Buttons-in-Mail"></a>
<div class="header">
<p>
Next: <a href="#Buttons-in-News" accesskey="n" rel="next">Buttons in News</a>, Previous: <a href="#Searching-and-Summarizing" accesskey="p" rel="prev">Searching and Summarizing</a>, Up: <a href="#Utilizing-Explicit-Buttons" accesskey="u" rel="up">Utilizing Explicit Buttons</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Buttons-in-Mail-1"></a>
<h4 class="subsection">3.7.6 Buttons in Mail</h4>

<a name="index-C_002dx-m"></a>
<a name="index-mail"></a>
<a name="index-menu-item_002c-Cust_002fMsg_002dToggle_002dEbuts"></a>
<p>Hyperbole supports embedding buttons within electronic mail messages
composed in Emacs.  An enhanced mail reader may then be used to
activate the buttons within messages just like any other buttons.
Because this involves complex changes to mail support functions, this
feature is disabled by default.  Use the Cust/Msg-Toggle-Ebuts
minibuffer menu item to enable it.
</p>
<a name="index-button-mailing"></a>
<a name="index-button-posting"></a>
<a name="index-mailing-buttons"></a>
<a name="index-posting-buttons"></a>
<a name="index-mail-reader"></a>
<a name="index-mailer-initialization"></a>
<a name="index-Rmail"></a>
<a name="index-VM"></a>
<a name="index-MH_002de"></a>
<a name="index-Gnus"></a>
<a name="index-USENET"></a>
<a name="index-news"></a>
<a name="index-file_002c-hmail_002eel"></a>
<p>Hyperbole supports the following mail readers: Rmail (see <a href="http://www.gnu.org/software/emacs/manual/html_mono/emacs.html#Rmail">Reading
Mail with Rmail</a> in <cite>the GNU Emacs Manual</cite>), VM (see <a href="vm.html#Introduction">Introduction</a> in <cite>the VM Manual</cite>) and MH-e.  Button inclusion and activation within USENET news
articles is also supported in the same fashion via the Gnus news reader if
available at your site (see <a href="http://www.gnu.org/software/emacs/manual/html_mono/gnus.html#Top">The Gnus Newsreader</a> in <cite>the Gnus
Manual</cite>).  (The <samp>hmail.el</samp> file defines a generalized interface that can
be used to hook in other mail or news readers if the necessary interface
functions are written.)
</p>
<a name="index-mail_002dyank_002doriginal"></a>
<a name="index-C_002dc-C_002dy"></a>
<a name="index-mail-inclusion"></a>
<p>All explicit buttons to be mailed must be created within the outgoing
message buffer. There is no present support for including text from
other buffers or files which contain explicit buttons, except for the
ability to yank the contents of a message being replied to, together
with all of its buttons, via the <code>(mail-yank-original)</code> command
bound to <kbd>{C-c C-y}</kbd>.  From a user&rsquo;s perspective, buttons are
created in precisely the same way as in any other buffer.  They also
appear just like any other buttons to both the message sender and the
reader who uses the Hyperbole enhanced readers.  Button operation may be
tested any time before a message is sent.  A person who does not use
Hyperbole enhanced mail readers can still send messages with embedded
buttons since mail composing is independent of any mail reader
choice.
</p>
<p>Hyperbole buttons embedded within received mail messages behave as do
any other buttons.  The mail does not contain any of the action type
definitions used by the buttons, so the receiver must have these or
she will receive an error when she activates the buttons.  Buttons
which appear in message <em>Subject</em> lines are copied to summary
buffers whenever such summaries are generated.  Thus, they may be
activated from either the message or the summary buffers.
</p>
<p>Nothing bad will happen if a mail message with explicit buttons is sent
to a non-Hyperbole user.  The user will simply see the text
of the message followed by a series of lines of button data at its end.
Hyperbole mail users never see this data in its raw form.
</p>
<a name="index-smail_003acomment"></a>
<a name="index-mail-comment"></a>
<a name="index-Hyperbole-mail-comment"></a>
<p>In order to alert readers of your mail messages that you can handle
Hyperbole mail buttons, you can set the variable, <code>smail:comment</code>,
to an expression that automatically inserts a comment into each
outgoing message to announce this fact.  See its documentation for
technical details.  By default, no comment is added.  To have a
comment line added to your outgoing message, add the following to
to your <samp>~/.emacs</samp> file before the point at which you load
Hyperbole.
</p>
<div class="lisp">
<pre class="lisp">(setq smail:comment
 (format &quot;Comments: GNU Hyperbole mail buttons accepted, v%s.\n&quot;
          hyperb:version))
</pre></div>

<p>This will produce the following line in outgoing messages:
</p>
<div class="example">
<pre class="example">Comments: GNU Hyperbole mail buttons accepted, vX.X.X.
</pre></div>

<a name="index-file_002c-_002eemacs-2"></a>
<p>where the X&rsquo;s indicate your Hyperbole version number.  You can cut
this out of particular messages before you send them when need be.
</p>
<a name="index-actype_002c-link_002dto_002dmail"></a>
<p>A final mail-related facility provided by Hyperbole is the ability to
save a pointer to a received mail message by creating an explicit button
with a <code>link-to-mail</code> action type.  When prompted for the mail
message to link to, if you press the Action Key within the message, the
appropriate link parameters will be copied to the argument prompt, as
described in <a href="#Smart-Key-Argument-Selection">Smart Key Argument Selection</a>.
</p>

<hr>
<a name="Buttons-in-News"></a>
<div class="header">
<p>
Previous: <a href="#Buttons-in-Mail" accesskey="p" rel="prev">Buttons in Mail</a>, Up: <a href="#Utilizing-Explicit-Buttons" accesskey="u" rel="up">Utilizing Explicit Buttons</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Buttons-in-News-1"></a>
<h4 class="subsection">3.7.7 Buttons in News</h4>

<a name="index-button-posting-1"></a>
<a name="index-news-reader_002fposter"></a>
<a name="index-posting-news"></a>
<a name="index-Gnus-1"></a>
<a name="index-USENET-1"></a>
<a name="index-file_002c-hyperbole_002eel-1"></a>
<a name="index-menu-item_002c-Cust_002fMsg_002dToggle_002dEbuts-1"></a>
<p>Explicit buttons may be embedded within outgoing USENET news articles
and may be activated from within the Gnus news reader.  Because this
involves complex changes to news support functions, this feature is
disabled by default.  Use the Cust/Msg-Toggle-Ebuts minibuffer menu
item to enable it (enabling it for mail also enables it for news and
vice versa).
</p>
<p>Once enabled, all Hyperbole support should work just as it does when
reading or sending mail.  See <a href="#Buttons-in-Mail">Buttons in Mail</a>.  When reading news,
buttons which appear in message <em>Subject</em> lines may be activated
within the Gnus subject buffer as well as the article buffer.  When
posting news, the *post-news* buffer is used for outgoing news
articles rather than a mail-related buffer.
</p>
<p>Remember that the articles you post do not contain the action type
definitions used by the buttons, so the receiver must have these or she
will receive an error when she activates the buttons.  You should also
keep in mind that most USENET readers will not be using Hyperbole, so if
they receive a news article containing explicit buttons, they will
wonder what the button data at the end of the message is.  You should
therefore limit distribution of such messages.  For example, if most
people at your site read news with Gnus and use Hyperbole, it would be
reasonable to embed buttons in postings to local newsgroups.
</p>
<a name="index-news-comment"></a>
<p>In order to alert readers of your postings that they may send you
personal replies with embedded Hyperbole buttons, the system inserts
into news postings the same comment that is included within mail
messages, if enabled.  See <a href="#Buttons-in-Mail">Buttons in Mail</a>, for details and an
explanation of how to turn this feature on.
</p>


<hr>
<a name="Menus"></a>
<div class="header">
<p>
Next: <a href="#HyControl" accesskey="n" rel="next">HyControl</a>, Previous: <a href="#Buttons" accesskey="p" rel="prev">Buttons</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Menus-1"></a>
<h2 class="chapter">4 Menus</h2>

<a name="index-Emacs-1"></a>
<a name="index-Hyperbole-menubar-menu"></a>
<a name="index-Hyperbole-pulldown-menu"></a>
<a name="index-menu-use"></a>
<a name="index-pulldown-menu"></a>
<a name="index-menubar_002c-Hyperbole-menu"></a>
<a name="index-menu-item_002c-Remove_002dThis_002dMenu"></a>
<a name="index-removing-Hyperbole-menu"></a>
<p>Pulldown and popup menus are available to invoke Hyperbole commands,
including those from the HyRolo and the Koutliner.  These menus operate
like any other application menus and are fairly self-explanatory.  Use
the <code>Remove-This-Menu</code> command on the Hyperbole menubar menu to
get rid of the menu if you do not need it.  Invoking Hyperbole from
the keyboard, as explained below, will add the menu back to the
menubar.  Here is the Hyperbole Menubar Menu and its Find submenu.
</p>
<div class="float"><a name="image_003aHyperbole-Menu"></a>

<img src="im/menu-hyperbole.png" alt="Hyperbole Menu">
<div class="float-caption"><p><strong>Image 4.1: </strong>Hyperbole Menubar Menu</p></div></div>
<div class="float"><a name="image_003aFind-Menu"></a>

<img src="im/menu-find.png" alt="Find Menu">
<div class="float-caption"><p><strong>Image 4.2: </strong>Find Menubar Menu</p></div></div><br>

<a name="index-hyperbole_002dpopup_002dmenu"></a>
<a name="index-popup-menu"></a>
<a name="index-hyperbole-popup-menu"></a>
<p>The Hyperbole popup menu, <code>hyperbole-popup-menu</code>, replicates the
Hyperbole menubar menu.  It can be bound to a mouse key but is not
bound to one by default.   It can also be assigned as the default
Action or Assist Key action to use when no matching context is found.
See <a href="#Smart-Key-_002d-Default-Context">Smart Key - Default Context</a>, for details.
</p>
<a name="index-minibuffer-menus"></a>
<a name="index-menu-item-key-bindings"></a>
<p>The rest of this section discusses only the
specialized <em>minibuffer menus</em> which appear in the minibuffer
window and work with all emacs versions on all display devices.  They
provide similar capabilities to those of the Hyperbole menubar but
additionally allow for fast menu item selection via the keyboard or
mouse.  When used with the keyboard, they provide command access
similar to key bindings.  In fact, any menu item can be bound to a
global key sequence.  See <a href="#Binding-Minibuffer-Menu-Items">Binding Minibuffer Menu Items</a>.
</p>
<a name="index-C_002dh-h"></a>
<a name="index-minibuffer-menu"></a>
<a name="index-file_002c-hyperbole_002eel-2"></a>
<a name="index-invoking-Hyperbole"></a>
<a name="index-starting-Hyperbole"></a>
<a name="index-Hyperbole_002c-starting"></a>
<a name="index-Hyperbole-main-menu"></a>
<p>The top-level Hyperbole minibuffer menu is invoked from a key given in your
<samp>hyperbole.el</samp> file (by default, <kbd>{C-h h}</kbd>) or with a click
of the Action Mouse Key in the minibuffer when it is inactive.  It should
look like this:
</p>
<div class="smallexample">
<pre class="smallexample">Hy&gt;  Act Butfile/ Cust/ Doc/ Ebut/ Find/ Gbut/ Hist Ibut/ Kotl/ Msg/ Rolo/ Screen/ Win/
</pre></div>

<a name="index-submenus"></a>
<a name="index-menu-help"></a>
<a name="index-help_002c-menu-items"></a>
<a name="index-menu-item-selection"></a>
<a name="index-selection_002c-menu-items"></a>
<a name="index-TAB"></a>
<a name="index-M_002df"></a>
<a name="index-Shift_002dTAB"></a>
<a name="index-M_002db"></a>
<p>All menu items are selected via the first character of their names (letter
case does not matter), with presses of the Action Key or by using
{<tt class="key">TAB</tt>} or <kbd>{M-f}</kbd> to move forward an item, <kbd>{Shift-<span class="key">TAB</span>}</kbd>
or <kbd>{M-b}</kbd> to move backward an item and {<tt class="key">RET</tt>} to select the
current item.  A press of the Assist Key on an item displays help for the
item, including the action that it performs.  &quot;/&quot; at the end of an item name
indicates that it brings up a submenu.
</p>
<a name="index-C_002dt"></a>
<a name="index-q"></a>
<a name="index-C_002dg"></a>
<a name="index-menu_002c-top_002dlevel"></a>
<a name="index-top_002dlevel-menu"></a>
<a name="index-menu-prefix"></a>
<p>While a menu is active, to re-activate the top-level Hyperbole menu,
use <kbd>{C-t}</kbd> or press the Action Key while on the menu prefix
(before the &lsquo;<samp>&gt;</samp>&rsquo; character).  This allows you to browse the
submenus and then return to the top menu.  You can quit without
selecting an item by using <kbd>{q}</kbd> or pressing {<tt class="key">RET</tt>} when at
the end of a menu.  <kbd>{C-g}</kbd> aborts from the minibuffer whether you
are at a menu prompt or any other Hyperbole prompt.
</p>
<p>The top-level Hyperbole minibuffer menu items serve the following purposes:
</p>
<dl compact="compact">
<dd><a name="index-menu-item_002c-Act"></a>
<a name="index-menu-item_002c-Activate_002dButton_002din_002dBuffer"></a>
</dd>
<dt><strong>Act</strong></dt>
<dd><p>Activate button at point or if there is no button at point, prompt for
a labeled explicit or implicit button from the current buffer to activate.
</p>
<a name="index-menu_002c-Button_002dFile"></a>
<a name="index-menu_002c-Butfile"></a>
<a name="index-button-file_002c-HYPB"></a>
<a name="index-file_002c-HYPB"></a>
</dd>
<dt><strong>Butfile/</strong></dt>
<dd><p>Easy access to a directory-specific or personal file of buttons.
<samp>HYPB</samp> is the name of the directory-specific button file and
<samp>~/.hyperb/HYPB</samp> is the personal file of global buttons.
These are good places to begin experimenting with button creation.
</p>
<a name="index-menu_002c-Customize"></a>
<a name="index-menu_002c-Cust"></a>
<a name="index-customize"></a>
<a name="index-option-settings"></a>
</dd>
<dt><strong>Cust/</strong></dt>
<dd><p>Hyperbole option customization.  This includes whether ftp and www
URLs are recognized by the <code>find-file</code> commands, where Hyperbole
link referents are displayed, where URLs are displayed, where web
search results are displayed, whether date stamps are added to rolo
entries, and whether to use proportional or windowful scrolling when a
Smart Key is pressed at the end of a line.
See <a href="#Customization">Customization</a>.
</p>
<a name="index-menu_002c-KeyBindings"></a>
<a name="index-key-binding_002c-menu"></a>
<a name="index-mouse-bindings"></a>
<p>The &lsquo;<samp>KeyBindings/</samp>&rsquo; submenu allows individual changes to each
keyboard key that Hyperbole binds for its commands, notably the Action
Key.  See <a href="#Smart-Key-Bindings">Smart Key Bindings</a>, for more information.
</p>
<p>See <a href="#Global-Key-Bindings">Global Key Bindings</a>, for complete descriptions of Hyperbole&rsquo;s
global key bindings, how to temporarily disable them and how to manage
its overriding of local bindings that hide global Hyperbole keys.
</p>
<a name="index-menu_002c-Explicit_002dButton"></a>
<a name="index-menu_002c-EBut"></a>
</dd>
<dt><strong>Ebut/</strong></dt>
<dd><p>All explicit button commands.  The window-system-based Hyperbole
menu includes an activation menu item for each explicit button found
in the current buffer.
</p>
<a name="index-menu_002c-Documentation"></a>
<a name="index-menu_002c-Doc"></a>
<a name="index-menu_002c-Types"></a>
</dd>
<dt><strong>Doc/</strong></dt>
<dd><p>Hyperbole documentation quick access.  This menu contains an About item
which describes Hyperbole and a Demo item which demonstrates a number of
interactive Hyperbole features.  It also contains the Types/ submenu for
documentation on Hyperbole implicit button and action types.
</p>
<a name="index-Find"></a>
<a name="index-Grep"></a>
<a name="index-menu_002c-Find"></a>
<a name="index-search"></a>
</dd>
<dt><strong>Find/</strong></dt>
<dd><p>Buffer and file line finding commands and web searching.  This menu
brings together many existing line finding commands that are difficult
to recall quickly when needed, simplifying finding and then jumping to
matching lines by using the Action Key.  It includes commands for
filtering a buffer to just those lines that either match or do not
match a regular expression.  It also includes a submenu for quick
access to popular web search engines.
</p>
<p>Below are each of the commands on the Find menu.
</p>
<a name="index-match-lines-2"></a>
<a name="index-remove-lines"></a>
<a name="index-save-lines"></a>
<a name="index-locate-files"></a>
<a name="index-grep-files"></a>
<a name="index-menu-item_002c-GrepFile"></a>
<a name="index-menu-item_002c-LocateFiles"></a>
<a name="index-menu-item_002c-MatchFileBuffers"></a>
<a name="index-menu-item_002c-OccurHere"></a>
<a name="index-menu-item_002c-RemoveLines"></a>
<a name="index-menu-item_002c-SaveLines"></a>
<a name="index-hypb_003argrep_002dcommand"></a>
<a name="index-locate_002dcommand"></a>
<ul>
<li> GrepFiles -        Show numbered line matches for a regexp in all
                   non-backup, non-auto-save files below the current directory.
                   If in an Emacs Lisp mode buffer and no PREFIX-ARG
                   is given, limit search to only .el and .el.gz
                   files.  Set <code>hypb:rgrep-command</code> to change the
                   grep command or options.

</li><li> LocateFiles -      Prompt for a pattern and display a list of all 
                   matching pathnames found throughout the file
                   system.  On Mac OS X, this uses Spotlight
                   (the <code>mdfind</code> command); on UNIX, it uses
                   the <code>locate</code> command.  Within the resulting
                   *Locate* buffer, Find/Grep-Files will find matching lines
                   within only these paths (files and directories).

</li><li> MatchFileBuffers - Show numbered line matches for regexp in all file-based buffers.

</li><li> OccurHere -        Show numbered line matches for regexp from this buffer.

</li><li> RemoveLines -      Following point, remove all lines that match regexp.

</li><li> SaveLines -        Following point, keep only lines that match regexp.
<a name="index-menu_002c-Find_002fWeb"></a>
<a name="index-menu_002c-Web"></a>
<a name="index-searching-the-web"></a>
<a name="index-web-search"></a>
<a name="index-C_002dc-_002f"></a>
<a name="index-hyperbole_002dweb_002dsearch_002dbrowser_002dfunction"></a>

</li><li> Web/ -             Select a search engine and term and search with them.
                   Hyperbole binds the key <kbd>{C-c /}</kbd> for quick
                   access to this menu, if it is not already bound
                   prior to Hyperbole&rsquo;s initialization.  The Cust/Web-Search
                   menu sets the option, <code>hyperbole-web-search-browser-function</code>,
                   which determines whether web search results are displayed
                   within Emacs or with an external web browser.  A short
                   video introduction to the Find/Web menu may be
                   found at <a href="https://youtu.be/8lMlJed0-OM">https://youtu.be/8lMlJed0-OM</a>.

<p>The Find/Web menu looks like this:
</p>
<div class="smallexample">
<pre class="smallexample">Web&gt;  Amazon Bing Dictionary Elisp Facebook Google Hub(git)
      Images Maps RFCs StackOverflow Twitter Wikipedia Youtube
</pre></div>
</li></ul>

<a name="index-menu_002c-Global_002dButton-1"></a>
<a name="index-menu_002c-Gbut-1"></a>
</dd>
<dt><strong>Gbut/</strong></dt>
<dd><p>All global button commands.  Global buttons are accessed by name
rather than by direct selection.  The Hyperbole menubar menu also
includes an activation menu item for each global button.
<a name="index-menu-item_002c-Back_002dto_002dPrior_002dLocation"></a>
<a name="index-menu-item_002c-Hist"></a>
<a name="index-history"></a>
</p></dd>
<dt><strong>Hist</strong></dt>
<dd><p>Return to previous positions in the button traversal history.
</p>
<a name="index-menu_002c-Implicit_002dButton"></a>
<a name="index-menu_002c-Ibut"></a>
</dd>
<dt><strong>Ibut/</strong></dt>
<dd><p>All implicit button commands.
</p>
<a name="index-menu_002c-Mail_002dLists"></a>
<a name="index-menu_002c-Msg"></a>
</dd>
<dt><strong>Msg/</strong></dt>
<dd><p>Hyperbole-specific email messaging commands.  Use this to send mail to
a Hyperbole discussion mailing list.
</p>
<a name="index-menu_002c-Outliner"></a>
<a name="index-menu_002c-Koutline"></a>
<a name="index-menu_002c-Kotl"></a>
</dd>
<dt><strong>Kotl/</strong></dt>
<dd><p>Autonumbered, structured outliner commands with per-node hyperlink anchors.
See <a href="#Koutliner">Koutliner</a>.
</p>
<a name="index-menu_002c-Rolo"></a>
</dd>
<dt><strong>Rolo/</strong></dt>
<dd><p>Hierarchical, multi-file contact manager lookup and edit commands.
See <a href="#HyRolo">HyRolo</a>.
</p>
<a name="index-menu_002c-Screen"></a>
</dd>
<dt><strong>Screen/</strong></dt>
<dd><p>Window, frame and buffer display control commands.  See <a href="#HyControl">HyControl</a>.
</p>
<a name="index-menu_002c-Window_002dConfigurations"></a>
<a name="index-menu_002c-WinConfig"></a>
</dd>
<dt><strong>Win/</strong></dt>
<dd><p>Window configuration management commands, such as adding and restoring
window configurations by name.  See <a href="#Window-Configurations">Window Configurations</a>.
</p>
</dd>
</dl>

<hr>
<a name="HyControl"></a>
<div class="header">
<p>
Next: <a href="#Koutliner" accesskey="n" rel="next">Koutliner</a>, Previous: <a href="#Menus" accesskey="p" rel="prev">Menus</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="HyControl-1"></a>
<h2 class="chapter">5 HyControl</h2>

<a name="index-windows-control"></a>
<a name="index-frames-control"></a>
<a name="index-HyControl"></a>
<a name="index-invoking-HyControl"></a>
<a name="index-starting-HyControl"></a>
<a name="index-screen"></a>
<a name="index-display"></a>
<p>Hyperbole includes the fastest, easiest-to-use Emacs window and frame
management system available, HyControl, found under the Hyperbole
Screen menu.  If you use a lot of Emacs windows or frames (typically,
window system windows) then this chapter is for you.
</p>
<p>HyControl interactively adjusts the layout of your windows and frames
down to the pixel-level if desired.  You adjust the location, size and
display elements of your windows and frames until they look as you like
and then simply quit HyControl and go back to work.
</p>
<a name="index-C_002dc-_005c"></a>
<a name="index-screen_002c-C_002dc-_005c"></a>
<a name="index-C_002dh-h-s-w"></a>
<a name="index-screen_002c-C_002dh-h-s-w"></a>
<a name="index-C_002dh-h-s-f"></a>
<a name="index-screen_002c-C_002dh-h-s-f"></a>
<a name="index-menu-item_002c-WindowsControl"></a>
<a name="index-menu-item_002c-FramesControl"></a>
<p>Hyperbole binds the key <kbd>{C-c \}</kbd> for quick access to HyControl&rsquo;s
window control menu, if it was not already bound prior to Hyperbole&rsquo;s
initialization; otherwise, the Screen/WindowsControl minibuffer menu
item, <kbd>{C-h h s w}</kbd>, will do the same thing.  To start HyControl
with the frames menu instead, use Screen/FramesControl, <kbd>{C-h h s
f}</kbd>.
</p>
<a name="index-submodes"></a>
<a name="index-screen_002c-t"></a>
<a name="index-screen_002c-q"></a>
<a name="index-screen_002c-Q"></a>
<p>Once in HyControl, your minibuffer window at the bottom of the
selected frame will display a summary of keys you may use to adjust
your windows until you press <kbd>{q}</kbd> or <kbd>{Q}</kbd> to quit from
HyControl.  The key, <kbd>{t}</kbd>, will always toggle between controlling
frames and windows, the <em>submodes</em> of HyControl, with the upper
left of the minibuffer prompt showing which type of control is active.
</p>
<a name="index-numeric-argument"></a>
<a name="index-multiplier"></a>
<p>A number of commands take a single numeric argument, e.g. movement and
sizing, which you can enter by typing a period to clear the argument,
followed by any positive number up to 1000.  You may also use
the <kbd>{C-u}</kbd> universal argument key to apply a multiplier of 4 to
the argument, any number of times.  Any entry that pushes the argument
over 1000, restarts it, so 10005 would produce an argument of 5.
</p>
<p>The table below explains what each key does in HyControl mode.  If the
explanation does not say otherwise, then the key applies in both window
and frame submodes.
</p>
<dl compact="compact">
<dd>
<a name="index-HyControl-help"></a>
<a name="index-HyControl_002c-see-screen"></a>
<a name="index-screen_002c-_003f"></a>
<a name="index-_003f"></a>
</dd>
<dt><kbd>{?}</kbd></dt>
<dd><p>Toggle whether HyControl displays key binding help in the minibuffer.
</p>
<a name="index-HyControl_002c-see-screen-1"></a>
<a name="index-screen_002c-_002e"></a>
<a name="index-_002e"></a>
</dd>
<dt><kbd>{.}</kbd></dt>
<dd><p>Clear the prefix argument to a value of 0.
</p>
<a name="index-screen_002c-0_002d9"></a>
<a name="index-0_002d9"></a>
</dd>
<dt><kbd>{0-9}</kbd></dt>
<dd><p>Multiply the prefix argument by 10 and add the digit pressed.
</p>
<a name="index-windows-grid"></a>
<a name="index-grid-of-windows"></a>
<a name="index-HyControl-windows-grid"></a>
<a name="index-screen_002c-_0040"></a>
<a name="index-_0040"></a>
</dd>
<dt><kbd>{@}</kbd></dt>
<dd>
<p>Display a <em>grid of windows</em> in the selected frame sized according to
the prefix argument or via a prompted input.  Left digit of the argument is
the number of grid rows and the right digit is the number of grid columns
to display.
</p>
<div class="float"><a name="image_003a2x3_002dWindows_002dGrid"></a>

<img src="im/wgrid-2x3.png" alt="2x3 Windows Grid">
<div class="float-caption"><p><strong>Image 5.1: </strong>2x3 Windows Grid</p></div></div><br>

<p>If the prefix argument is 0, prompt for a major mode whose buffers
should be displayed first in the grid windows, then prompt for the grid size.
</p>
<p>Otherwise, prompt for the grid size if the prefix argument is an invalid
size.
</p>
<a name="index-hycontrol_002ddisplay_002dbuffer_002dpredicate_002dlist"></a>
<p>With a current buffer in Dired, Buffer Menu or IBuffer mode that
contains marked items, the buffers associated with those items are
displayed first in the grid (unless the prefix argument is 0).
</p>
<p>Then the most recently used buffers are displayed in each window, first
selecting only those buffers which match any of the predicate expressions
in <code>hycontrol-display-buffer-predicate-list</code>.  (The default predicate
list chooses buffers with attached files).
</p>
<p>Then, if there are not enough buffers for all windows, the buffers that
failed to match to any predicate are used. In all cases, buffers whose
names start with a space are ignored.
</p>
<p>When done, this resets the persistent prefix argument to 1 to prevent
following commands from using the often large grid size argument.
</p>
<p>If you ever need to experiment with different sized window grids, use
<kbd>{M-x hycontrol-window-grid-repeatedly <span class="key">RET</span>}</kbd>.  It will
repeatedly prompt you for a grid size and then display it.  When you
are done, simply press <kbd>{<span class="key">RET</span>}</kbd> to exit.
</p>
<a name="index-frame-resize"></a>
<a name="index-hycontrol_002dframe_002dwidths"></a>
<a name="index-screen_002c-a"></a>
<a name="index-a"></a>
</dd>
<dt><kbd>{a}</kbd></dt>
<dd><p>Cycle through common width adjustments of a frame, such as 25% and
50%. Widths are given in screen percentages by the list
<code>hycontrol-frame-widths</code> and typically go from widest to
narrowest.
</p>
<a name="index-hycontrol_002dframe_002dheights"></a>
<a name="index-screen_002c-A"></a>
<a name="index-A"></a>
</dd>
<dt><kbd>{A}</kbd></dt>
<dd><p>Cycle through common height adjustments of a frame, such as 33.3% and
75%.  Heights are given in screen percentages by the list
<code>hycontrol-frame-heights</code> and typically go from tallest to shortest.
</p>
<a name="index-screen_002c-h"></a>
<a name="index-h"></a>
</dd>
<dt><kbd>{h}</kbd></dt>
<dd><p>Increase height by argument lines (line height determined by buffer
character height).
</p>
<a name="index-screen_002c-s"></a>
<a name="index-s"></a>
</dd>
<dt><kbd>{s}</kbd></dt>
<dd><p>Shorten height by argument lines.
</p>
<a name="index-screen_002c-w"></a>
<a name="index-w"></a>
</dd>
<dt><kbd>{w}</kbd></dt>
<dd><p>Widen by argument characters.
</p>
<a name="index-screen_002c-n"></a>
<a name="index-n"></a>
</dd>
<dt><kbd>{n}</kbd></dt>
<dd><p>Narrow by argument characters.
</p>
<a name="index-screen_002c-_0025"></a>
<a name="index-_0025"></a>
</dd>
<dt><kbd>{%}</kbd></dt>
<dd><p>In FRAMES mode, resize frame&rsquo;s height and width to about argument percent
of the screen size.
</p>
<a name="index-screen_002c-H"></a>
<a name="index-H"></a>
</dd>
<dt><kbd>{H}</kbd></dt>
<dd><p>In FRAMES mode, resize frame&rsquo;s height to about argument percent of the
screen size.
</p>
<a name="index-screen_002c-W"></a>
<a name="index-W"></a>
</dd>
<dt><kbd>{W}</kbd></dt>
<dd><p>In FRAMES mode, resize frame&rsquo;s width to about argument percent of the
screen size.
</p>
<a name="index-screen_002c-up"></a>
<a name="index-screen_002c-down"></a>
<a name="index-screen_002c-left"></a>
<a name="index-screen_002c-right"></a>
<a name="index-up"></a>
</dd>
<dt><kbd>{up}</kbd></dt>
<dd><a name="index-down"></a>
</dd>
<dt><kbd>{down}</kbd></dt>
<dd><a name="index-left"></a>
</dd>
<dt><kbd>{left}</kbd></dt>
<dd><a name="index-right"></a>
</dd>
<dt><kbd>{right}</kbd></dt>
<dd><p>Move frame in the specified direction by argument pixels.
</p>
<a name="index-frame-relocate"></a>
<a name="index-screen_002c-c"></a>
<a name="index-c"></a>
</dd>
<dt><kbd>{c}</kbd></dt>
<dd><p>With each press, cycle the selected frame&rsquo;s position clockwise through
the middle of edges and corners of the screen.  With an argument of 0,
reset the cycle position to the upper left corner.  Respects the pixel
edge offsets returned by <code>hycontrol-get-screen-offsets</code>.
</p>
<a name="index-delete-frame"></a>
<a name="index-frame_002c-delete"></a>
<a name="index-screen_002c-d"></a>
<a name="index-d"></a>
</dd>
<dt><kbd>{d}</kbd></dt>
<dd><p>Delete selected window or frame based on mode.
<a name="index-screen_002c-D"></a>
<a name="index-D"></a>
</p></dd>
<dt><kbd>{D}</kbd></dt>
<dd><p>Prompt for confirmation and then delete non-selected windows or frames
based on mode.
</p>
<a name="index-frame_002c-lower"></a>
<a name="index-lower-frame"></a>
<a name="index-screen_002c-l"></a>
<a name="index-l"></a>
</dd>
<dt><kbd>{l}</kbd></dt>
<dd><p>In FRAMES mode, lower the selected frame below all other Emacs session frames.
</p>
<a name="index-frame_002c-other"></a>
<a name="index-other-frame"></a>
<a name="index-other-window"></a>
<a name="index-window_002c-other"></a>
<a name="index-screen_002c-o"></a>
<a name="index-o"></a>
</dd>
<dt><kbd>{o}</kbd></dt>
<dd><p>Select the next window in the window list, across all visible frames.
<a name="index-screen_002c-O"></a>
<a name="index-O"></a>
</p></dd>
<dt><kbd>{O}</kbd></dt>
<dd><p>Select the next visible frame.
</p>
<a name="index-keypad"></a>
<a name="index-numeric-keypad"></a>
<a name="index-screen_002c-keypad-number"></a>
<a name="index-keypad-number"></a>
</dd>
<dt><kbd>{keypad number}</kbd></dt>
<dd><p>In FRAMES mode, move the frame directly to the screen edge position given
by the numeric keypad layout.  For example, 3 moves the frame to the
bottom right corner and 8 moves it to the middle of the top edge.
Keypad numeric keys do not adjust the argument.  Respects the pixel edge
offsets returned by <code>hycontrol-get-screen-offsets</code>.
</p>
<a name="index-virtual-numeric-keypad"></a>
<a name="index-screen_002c-p"></a>
<a name="index-p"></a>
</dd>
<dt><kbd>{p}</kbd></dt>
<dd><p>Display a virtual numeric keypad for emulating a keypad on keyboards without one.
Each digit key operates just as a numeric keypad key would.
</p>
<a name="index-frame_002c-raise"></a>
<a name="index-raise-frame"></a>
<a name="index-screen_002c-r"></a>
<a name="index-r"></a>
</dd>
<dt><kbd>{r}</kbd></dt>
<dd><p>In FRAMES mode, raise the selected frame above all other Emacs session frames.
</p>
<a name="index-window_002c-make"></a>
<a name="index-make-window"></a>
<a name="index-hycontrol_002dframe_002doffset"></a>
<a name="index-screen_002c-_005b"></a>
<a name="index-_005b"></a>
</dd>
<dt><kbd>{[}</kbd></dt>
<dd><p>Create a new atop window or frame depending on mode.  If a frame, it is
sized to the same size as the selected window and offset from the
selected frame by the pixel amounts given by
<code>hycontrol-frame-offset</code>.
<a name="index-screen_002c-_005d"></a>
<a name="index-_005d"></a>
</p></dd>
<dt><kbd>{]}</kbd></dt>
<dd><p>Create a new sideways window or frame depending on mode.
</p>
<a name="index-frame-configuration"></a>
<a name="index-window-configuration"></a>
<a name="index-screen_002c-_0028"></a>
<a name="index-_0028"></a>
</dd>
<dt><kbd>{(}</kbd></dt>
<dd><p>Save the current window or frame configuration based on mode.  Whenever,
HyControl is invoked, the current window and frame configurations are
saved automatically.  So use this command only if you have changed the
configuration and wish to save it temporarily.
<a name="index-screen_002c-_0029"></a>
<a name="index-_0029"></a>
</p></dd>
<dt><kbd>{)}</kbd></dt>
<dd><p>After confirmation, restore the last saved window or frame configuration
based on mode.
</p>
<a name="index-window_002c-clone-1"></a>
<a name="index-clone-window-1"></a>
<a name="index-hycontrol_002dkeep_002dwindow_002dflag"></a>
<a name="index-screen_002c-f"></a>
<a name="index-f"></a>
</dd>
<dt><kbd>{f}</kbd></dt>
<dd><p>Clone the selected window to a new similarly sized frame.
<a name="index-screen_002c-F"></a>
<a name="index-F"></a>
</p></dd>
<dt><kbd>{F}</kbd></dt>
<dd><p>Clone the selected window to a new similarly sized frame.  Delete the
original window unless there is only one window in the source frame or
if <code>hycontrol-keep-window-flag</code> is non-nil.
</p>
<a name="index-frame_002c-to-edge"></a>
<a name="index-frame_002c-percentage-resize"></a>
<a name="index-resize-frame-percentage"></a>
<a name="index-screen_002c-i"></a>
<a name="index-screen_002c-j"></a>
<a name="index-screen_002c-k"></a>
<a name="index-screen_002c-m"></a>
<a name="index-i"></a>
</dd>
<dt><kbd>{i}</kbd></dt>
<dd><a name="index-j"></a>
</dd>
<dt><kbd>{j}</kbd></dt>
<dd><a name="index-k"></a>
</dd>
<dt><kbd>{k}</kbd></dt>
<dd><a name="index-m"></a>
</dd>
<dt><kbd>{m}</kbd></dt>
<dd><p>Expand the selected frame to the respective screen edge based on U.S.
keyboard key layout.  i=top, j=left, k=right and m=bottom screen edge.
If already at the edge, adjusts the perpendicular dimension to ARG percent
of the screen (50% by default if ARG is 1 or nil) but keep it at the screen
edge.  Respects the pixel edge offsets returned by
<code>hycontrol-get-screen-offsets</code>.
</p>
<a name="index-balance-windows"></a>
<a name="index-windows_002c-balance"></a>
<a name="index-equalize-windows"></a>
<a name="index-windows_002c-equalize"></a>
<a name="index-screen_002c-_003d"></a>
<a name="index-_003d"></a>
</dd>
<dt><kbd>{=}</kbd></dt>
<dd><p>After confirmation, in WINDOWS mode, make the current frame&rsquo;s windows
approximately the same size.  In FRAMES mode, make all visible frames
the size of the selected frame.
</p>
<a name="index-shrink-window"></a>
<a name="index-window_002c-shrink"></a>
<a name="index-screen_002c-_002d"></a>
<a name="index-_002d"></a>
</dd>
<dt><kbd>{-}</kbd></dt>
<dd><p>In WINDOWS mode, shrink window to its smallest possible number of lines
to display the entire buffer, if possible.  Otherwise or if the window
is already displaying all of its lines, shrink it to about one line,
if possible.
</p>
<a name="index-frame_002c-shrink"></a>
<a name="index-shrink-frame"></a>
<p>In FRAMES mode, make the frame as small as possible while still
displaying it.
</p>
<a name="index-window_002c-maximize"></a>
<a name="index-maximize-window"></a>
<a name="index-frame_002c-maximize"></a>
<a name="index-maximize-frame"></a>
<a name="index-screen_002c-_002b"></a>
<a name="index-_002b"></a>
</dd>
<dt><kbd>{+}</kbd></dt>
<dd><p>Make the window or frame (based on mode) as large as possible.  In FRAMES
mode, a second press of this key restores its size to whatever it was prior
to the first use of this command.
</p>
<a name="index-burying"></a>
<a name="index-unburying"></a>
<a name="index-buffer_002c-bury"></a>
<a name="index-buffer_002c-unbury"></a>
<a name="index-screen_002c-b"></a>
<a name="index-b"></a>
</dd>
<dt><kbd>{b}</kbd></dt>
<dd><p>Bury the selected buffer within the buffer list, displaying the next
buffer.
<a name="index-screen_002c-u"></a>
<a name="index-u"></a>
</p></dd>
<dt><kbd>{u}</kbd></dt>
<dd><p>Unbury the bottom buffer in the buffer list and display it in the
selected window.
</p>
<a name="index-swapping"></a>
<a name="index-buffer_002c-swap-1"></a>
<a name="index-screen_002c-_007e"></a>
<a name="index-_007e"></a>
</dd>
<dt><kbd>{~}</kbd></dt>
<dd><p>Swap two buffers between the selected window or frame and one other.
In WINDOWS mode, there must be precisely two windows in the selected
frame.  In FRAMES mode, the second frame must have a single window.
</p>
<a name="index-zooming"></a>
<a name="index-window_002c-zoom"></a>
<a name="index-frame_002c-zoom"></a>
<a name="index-zoom_002dfrm_002eel"></a>
<a name="index-screen_002c-Z"></a>
<a name="index-Z"></a>
</dd>
<dt><kbd>{Z}</kbd></dt>
<dd><p>Zoom in selected window or frame text based on mode, increasing default
face size.
<a name="index-screen_002c-z"></a>
<a name="index-z"></a>
</p></dd>
<dt><kbd>{z}</kbd></dt>
<dd><p>Zoom out selected window or frame text based on mode, increasing default
face size.  Zooming supports an argument of between 1 and 9 (any other
value sets the argument to 1).  The argument determines the number of
sizes by which to zoom.
</p>
<p>FRAMES mode zooming requires the separately available
<samp>zoom-frm.el</samp> library.  WINDOWS zooming works without this library.
</p>
<a name="index-HyControl-switch-modes"></a>
<a name="index-HyControl-toggle-modes"></a>
<a name="index-toggle-HyControl-mode"></a>
<a name="index-screen_002c-t-1"></a>
<a name="index-t"></a>
</dd>
<dt><kbd>{t}</kbd></dt>
<dd><p>Toggle between WINDOWS and FRAMES submodes.
</p>
<a name="index-HyControl-quit"></a>
<a name="index-HyControl-exit"></a>
<a name="index-quit-HyControl"></a>
<a name="index-exit-HyControl"></a>
<a name="index-screen_002c-Q-1"></a>
<a name="index-screen_002c-q-1"></a>
<a name="index-Q"></a>
</dd>
<dt><kbd>{Q}</kbd></dt>
<dd><a name="index-q-1"></a>
</dd>
<dt><kbd>{q}</kbd></dt>
<dd><p>Press <kbd>{Q}</kbd> to globally quit HyControl mode and restore normal key bindings.
Typically <kbd>{q}</kbd> works as well, unless in a help buffer where
<kbd>{q}</kbd> is bound to <code>quit-window</code>, then that is run instead of quitting
HyControl.  A second press of <kbd>{q}</kbd> will then quit HyControl.
</p></dd>
</dl>

<br>
<p>The rest of this section goes into some technicalities about HyControl
settings.  You may ignore it if you are not familiar with Emacs
variables and functions or with customized Emacs.
</p>
<a name="index-HyControl-edge-placement"></a>
<a name="index-HyControl-corner-placement"></a>
<p>HyControl allows placement of frames at screen edges and corners with the
frame cycle command, <kbd>{c}</kbd>, and direct placement using the layout of the
numeric keypad keys, if available, or the <kbd>p</kbd> virtual keypad key
otherwise.  (Note that a screen may span multiple physical monitors).
</p>
<a name="index-HyControl-screen-edge-offsets"></a>
<a name="index-screen_002c-edge-offsets"></a>
<a name="index-hycontrol_002dscreen_002doffset_002dalist"></a>
<a name="index-hycontrol_002dset_002dscreen_002doffsets"></a>
<a name="index-hycontrol_002dget_002dscreen_002doffsets"></a>
<p>To prevent widgets and toolbars at the corners of the screen from
being obscured, HyControl can offset each frame from each screen edge
by a fixed number of pixels.  These offsets are specified by the
variable,<code>hycontrol-screen-offset-alist</code> and can differ for each type of
screen; see its documentation for details.  If you change its value,
then call <code>hycontrol-set-screen-offsets</code> to set any new offset
values.  <code>hycontrol-get-screen-offsets</code> returns the list of offsets
in clockwise order starting from the top edge.  Both functions display a
minibuffer message with the current offsets when called interactively.
</p>
<a name="index-hycontrol_002dframe_002doffset-1"></a>
<a name="index-frame_002c-make"></a>
<a name="index-make-frame"></a>
<p>When HyControl creates a new frame, it automatically sizes it to the
same size as the previously selected frame and offsets it from that
frame by the (X . Y) number of pixels given in the variable,
<code>hycontrol-frame-offset</code>.
</p>
<a name="index-file_002c-hycontrol_002eel"></a>
<a name="index-hycontrol_002denable_002dframes_002dmode"></a>
<a name="index-hycontrol_002denable_002d_002dwindows_002dmode"></a>
<p>The source code for the HyControl system is in <samp>hycontrol.el</samp>
within your Hyperbole source directory, given by <code>hyperb:dir</code>.
HyControl uses standard Emacs keymaps, so any keys can be rebound.
Remember that Hyperbole typically binds <kbd>{C-c \}</kbd> to the windows
control menu, but if you would like to bind either of the two
HyControl minor mode invocation commands to keys, they are,
<code>hycontrol-enable-windows-mode</code> and <code>hycontrol-enable-frames-mode</code>.
Generally, you need only one of these bound to a key since when you
press that key, the other command can be reached by pressing <kbd>{t}</kbd>.
</p>

<hr>
<a name="Koutliner"></a>
<div class="header">
<p>
Next: <a href="#HyRolo" accesskey="n" rel="next">HyRolo</a>, Previous: <a href="#HyControl" accesskey="p" rel="prev">HyControl</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Koutliner-1"></a>
<h2 class="chapter">6 Koutliner</h2>

<a name="index-outliner"></a>
<a name="index-autonumber"></a>
<a name="index-relative-autonumber"></a>
<a name="index-permanent-identifier"></a>
<a name="index-idstamp"></a>
<a name="index-hyperlink-anchor"></a>
<p>The Hyperbole outliner, the Koutliner (pronounced Kay-outliner),
produces structured, autonumbered documents composed of hierarchies of
cells.  Each <em>cell</em> has two identifiers, a
<em>relative identifier</em> indicating its present position within the
outline and a <em>permanent identifier</em> called an <em>idstamp</em>,
suitable for use within hyperlink references to the cell.  The idstamp
is typically not displayed but is available when needed.
See <a href="#Autonumbering">Autonumbering</a>.
</p>
<p>Cells also store their time of creation and the user who created the
cell.  User-defined attributes may also be added to cells.  See <a href="#Cell-Attributes">Cell Attributes</a>.
</p>
<a name="index-file_002c-EXAMPLE_002ekotl"></a>
<a name="index-menu_002c-Outline_002fExample"></a>
<a name="index-C_002dh-h-k-e"></a>
<p>This chapter expands on the information given in the <samp>EXAMPLE.kotl</samp>
file included with Hyperbole.  Use <kbd>{C-h h k e}</kbd> to display that
file, as pictured on the following page.  It is an actual outline file
that explains major outliner operations.  You can test out the viewing,
editing and motion commands with this file since a personal copy is made
when you invoke this command.
</p>
<p>See <a href="#Koutliner-Keys">Koutliner Keys</a>, for a full summary of the key bindings and
commands available in the Koutliner.
</p>
<div class="float"><a name="image_003aKoutliner"></a>

<img src="im/koutliner.png" alt="Koutliner Screenshot">
<div class="float-caption"><p><strong>Image 6.1: </strong>Koutliner Screenshot</p></div></div><br>

<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">&bull; <a href="#Menu-Commands" accesskey="1">Menu Commands</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Creating-Outlines" accesskey="2">Creating Outlines</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Autonumbering" accesskey="3">Autonumbering</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Idstamps" accesskey="4">Idstamps</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Editing" accesskey="5">Editing</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Viewing" accesskey="6">Viewing</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Links" accesskey="7">Links</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Cell-Attributes" accesskey="8">Cell Attributes</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Koutliner-History" accesskey="9">Koutliner History</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
</table>


<hr>
<a name="Menu-Commands"></a>
<div class="header">
<p>
Next: <a href="#Creating-Outlines" accesskey="n" rel="next">Creating Outlines</a>, Previous: <a href="#Koutliner" accesskey="p" rel="prev">Koutliner</a>, Up: <a href="#Koutliner" accesskey="u" rel="up">Koutliner</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Menu-Commands-1"></a>
<h3 class="section">6.1 Menu Commands</h3>

<p>The Kotl/ menu entry on the Hyperbole minibuffer menu provides access to
a number of major Koutliner commands:
</p>
<a name="index-outliner-commands"></a>
<a name="index-Koutliner-commands"></a>
<a name="index-Koutliner-menu"></a>
<a name="index-menu_002c-Koutliner"></a>
<a name="index-kotl_002dmode_003ashow_002dall"></a>
<a name="index-kvspec_003atoggle_002dblank_002dlines"></a>
<a name="index-kfile_003afind"></a>
<a name="index-kotl_002dmode_003ahide_002dsublevels"></a>
<a name="index-kotl_002dmode_003ahide_002dtree"></a>
<a name="index-kotl_002dmode_003akill_002dtree"></a>
<a name="index-klink_003acreate"></a>
<a name="index-kotl_002dmode_003aoverview"></a>
<a name="index-kotl_002dmode_003ashow_002dtree"></a>
<a name="index-kotl_002dmode_003atop_002dcells"></a>
<a name="index-kvspec_003aactivate"></a>
<div class="example">
<pre class="example">Menu Item    Command                    Description
====================================================================
All          kotl-mode:show-all         Expand all cells
Blanks       kvspec:toggle-blank-lines  Toggle blank lines on or off
Create       kfile:find                 Edit or create an outline
Downto       kotl-mode:hide-sublevels   Hide cells deeper than a level
Examp        &lt;sample outliner file&gt;     Show self-descriptive example
Hide         kotl-mode:hide-tree        Hide tree with root at point
Info         &lt;outliner documentation&gt;   Show outliner manual section
Kill         kotl-mode:kill-tree        Kill the current tree
Link         klink:create               Create a link to another cell
Overvw       kotl-mode:overview         Show first line of each cell
Show         kotl-mode:show-tree        Show tree with root at point
Top          kotl-mode:top-cells        Collapse to top-level cells
Vspec        kvspec:activate            Set a view specification
====================================================================
</pre></div>

<a name="index-C_002dmouse_002d3"></a>
<a name="index-popup-menu_002c-Koutliner"></a>
<a name="index-menubar-menu_002c-Koutliner"></a>
<p>The popup and menubar Koutline menu, as displayed here, offers a more
complete set of the Koutliner commands.  <kbd>{C-mouse-3}</kbd> pops up the
mode-specific menu in Emacs.  Experiment with the menu or
read the following sections explaining commands.
</p>
<div class="float"><a name="image_003aKoutline-Menu"></a>

<img src="im/menu-koutline.png" alt="Koutline Menu">
<div class="float-caption"><p><strong>Image 6.2: </strong>Koutline Menu</p></div></div><br>

<hr>
<a name="Creating-Outlines"></a>
<div class="header">
<p>
Next: <a href="#Autonumbering" accesskey="n" rel="next">Autonumbering</a>, Previous: <a href="#Menu-Commands" accesskey="p" rel="prev">Menu Commands</a>, Up: <a href="#Koutliner" accesskey="u" rel="up">Koutliner</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Creating-Outlines-1"></a>
<h3 class="section">6.2 Creating Outlines</h3>

<a name="index-outline-file-suffix"></a>
<a name="index-outline_002c-creating"></a>
<a name="index-file_002c-_002ekotl-suffix"></a>
<p>In addition to the Kotl/Create menu item, you can create and experiment
with outline files simply by finding a file, <kbd>{C-x C-f}</kbd>, with a
<samp>.kotl</samp> suffix.  <samp>.kot</samp> will also work for users impaired by
operating systems with 3-character suffix limitations.
</p>
<a name="index-root-cell"></a>
<a name="index-top_002dlevel-cell"></a>
<a name="index-cell_002c-top_002dlevel"></a>
<a name="index-cell_002c-idstamp-0"></a>
<p>When a new koutline is created, an invisible root cell is added.  Its
permanent and relative ids are both 0, and it is considered to be at
level 0 in the outline.  All visible cells in the outline are at level 1
or deeper, and thus are descendants of this root cell.  Some koutliner
commands prompt for cell numbers as arguments.  An argument of 0 makes
commands operate upon the entire outline.
</p>
<p>An initial level 1 cell is also created to make it easy to start
entering text in the outline.  A koutline always has at least one
visible cell in it.
</p>
<p>See <a href="#Autonumbering">Autonumbering</a>, which explains how cells are labeled according to their
respective levels in the outline and how these labels are updated as the
structure of the outline changes.
</p>

<hr>
<a name="Autonumbering"></a>
<div class="header">
<p>
Next: <a href="#Idstamps" accesskey="n" rel="next">Idstamps</a>, Previous: <a href="#Creating-Outlines" accesskey="p" rel="prev">Creating Outlines</a>, Up: <a href="#Koutliner" accesskey="u" rel="up">Koutliner</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Autonumbering-1"></a>
<h3 class="section">6.3 Autonumbering</h3>

<a name="index-autonumber-1"></a>
<a name="index-relative-identifier"></a>
<p>See <a href="#Adding-and-Killing">Adding and Killing</a>, for information on how to add new cells to or
remove cells from a koutline.  As you do this, or as you promote or
demote cells within the outline, the labels preceding the contents of
each cell automatically update to reflect the new structure.  These
labels are also known as <em>autonumbers</em> and as <em>relative ids</em>
because they change as the structure changes.
</p>
<a name="index-outline-structure"></a>
<p>The outline structure is shown by these labels and by the indentation of
each outline level.  Normally, each deeper level is indented another
three characters, to reflect the nesting.
</p>
<a name="index-label-type_002c-alpha"></a>
<a name="index-label-type_002c-legal"></a>
<a name="index-alpha-labels"></a>
<a name="index-legal-labels"></a>
<a name="index-outline_002c-label-type"></a>
<p>The default autonumbers are called <em>alphanumeric labels</em> because
they alternate between using numbers and letters to distinguish each
successive level.  Each alphanumeric label uniquely identifies a cell&rsquo;s
position in an outline, so that there is no need to scan back to prior
cells to see what the current section number of an outline is.  This is
similar to a legal numbering scheme but without all the period
characters between level numbers.  As an example, 1b3 is equivalent to a
legal label of 1.2.3.  Both refer to the 3rd cell at level 3,
below the 2nd child of the first cell at level 1.  Said another way,
this is the 3rd child of the 1st cell&rsquo;s 2nd child.  In other words, it
is easier to visualize hierarchies than to talk about them.
</p>
<p>Alphanumeric labels are the default because they are shorter and easier
to read aloud than equivalent legal ones.  They also simplify
distinguishing between even and odd level labels because of the
alternating character set.
</p>
<a name="index-koutliner_002c-C_002dc-C_002dl"></a>
<a name="index-label-type_002c-changing"></a>
<p>You can change the labeling scheme used in a particular outline with
the command <kbd>{C-c C-l}</kbd>.  A <kbd>{?}</kbd> will show all of the
labeling options.  The default, alpha labels, legal labels, and
permanent idstamps (permanent cell ids) are all available.
</p>
<a name="index-label-separator_002c-changing"></a>
<a name="index-cell_002c-label-separator"></a>
<a name="index-outline_002c-label-separator"></a>
<a name="index-koutliner_002c-C_002dc-M_002dl"></a>
<a name="index-koutliner_002c-C_002du-C_002dc-M_002dl"></a>
<p>A cell label is normally followed by a period and a space, called the
<em>label separator</em>, prior to the start of the cell contents.  You can
change the separator for the current outline with <kbd>{C-c M-l}</kbd>.
<kbd>{C-u C-c M-l}</kbd> will additionally change the default separator
value used when new outlines are created (for the current session only).
For example, use the value &quot;  &quot; (two spaces) to get eliminate the
trailing period after each cell label.  The separator must be at least
two characters long but may be longer.
</p>
<a name="index-file_002c-_002eemacs-3"></a>
<a name="index-initialization-file"></a>
<p>If you find a separator that you prefer for all outlines, change the
separator setting permanently by adding the following line to your Emacs
initialization file, <samp>~/.emacs</samp>, substituting for &lsquo;your-separator&rsquo;:
</p>
<a name="index-label-separator_002c-default"></a>
<a name="index-kview_003adefault_002dlabel_002dseparator"></a>
<div class="lisp">
<pre class="lisp">(setq kview:default-label-separator &quot;your-separator&quot;)
</pre></div>


<hr>
<a name="Idstamps"></a>
<div class="header">
<p>
Next: <a href="#Editing" accesskey="n" rel="next">Editing</a>, Previous: <a href="#Autonumbering" accesskey="p" rel="prev">Autonumbering</a>, Up: <a href="#Koutliner" accesskey="u" rel="up">Koutliner</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Idstamps-1"></a>
<h3 class="section">6.4 Idstamps</h3>

<a name="index-permanent-identifier-1"></a>
<a name="index-idstamp-1"></a>
<p>Idstamps (permanent ids) are associated with each cell.  They maintain
hyperlinks as cells are reordered within a koutline.  See <a href="#Links">Links</a>.
Idstamps may be displayed in place of the outline level relative ids.
Use <kbd>{C-c C-l id <span class="key">RET</span>}</kbd>.
</p>
<a name="index-idstamp-counter"></a>
<p>An idstamp counter for each outline starts at 0 and is incremented by
one each time a cell is added to the outline.  This idstamp stays with
the cell no matter where it is moved within the outline.  If the cell is
deleted, its idstamp is not reused.
</p>
<a name="index-root-cell-1"></a>
<a name="index-top_002dlevel-cell-1"></a>
<a name="index-cell_002c-top_002dlevel-1"></a>
<a name="index-cell_002c-idstamp-0-1"></a>
<a name="index-idstamp-0"></a>
<p>The 0 idstamp is always assigned to the root node of the entire outline.
This node is never visible within the outline, but is used so that the
outline may be treated as a single tree when needed.  Idstamps always
begin with a 0, as in 012, to distinguish them from relative ids.
</p>

<hr>
<a name="Editing"></a>
<div class="header">
<p>
Next: <a href="#Viewing" accesskey="n" rel="next">Viewing</a>, Previous: <a href="#Idstamps" accesskey="p" rel="prev">Idstamps</a>, Up: <a href="#Koutliner" accesskey="u" rel="up">Koutliner</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Editing-1"></a>
<h3 class="section">6.5 Editing</h3>

<p>Text editing within the Koutliner works just as it does for other
buffers, except when you need to deal with the structural components of
an outline.  Within the contents of a cell, all of your standard editing
keys should work properly.  You can just type in text and the left and
right margins of the lines will be maintained for you.  See <a href="#Filling">Filling</a>,
for the times when you need to refill a paragraph or to control when
filling occurs.
</p>
<p>Don&rsquo;t invoke editing commands with <kbd>{M-x command-name <span class="key">RET</span>}</kbd>
since the Koutliner uses differently named commands made to act
like the regular editing commands.  Koutliner commands, however, account
for the structure and indentation in koutlines.
</p>
<a name="index-cell_002c-selection"></a>
<p>You may use the mouse to select parts of the contents of a single cell
for editing.  But don&rsquo;t drag across cell boundaries and then edit the
selected region, since that will destroy the outline structure.
</p>
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">&bull; <a href="#Adding-and-Killing" accesskey="1">Adding and Killing</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Relocating-and-Copying" accesskey="2">Relocating and Copying</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Moving-Around" accesskey="3">Moving Around</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Filling" accesskey="4">Filling</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Transposing" accesskey="5">Transposing</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Splitting-and-Appending" accesskey="6">Splitting and Appending</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Inserting-and-Importing" accesskey="7">Inserting and Importing</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Exporting" accesskey="8">Exporting</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
</table>

<hr>
<a name="Adding-and-Killing"></a>
<div class="header">
<p>
Next: <a href="#Relocating-and-Copying" accesskey="n" rel="next">Relocating and Copying</a>, Previous: <a href="#Editing" accesskey="p" rel="prev">Editing</a>, Up: <a href="#Editing" accesskey="u" rel="up">Editing</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Adding-and-Killing-1"></a>
<h4 class="subsection">6.5.1 Adding and Killing</h4>

<a name="index-koutliner_002c-C_002dj"></a>
<a name="index-koutliner_002c-C_002du-c_002dj"></a>
<a name="index-koutliner_002c-C_002dc-a"></a>
<a name="index-koutliner_002c-C_002dc-p"></a>
<a name="index-cell_002c-adding"></a>
<a name="index-cell_002c-creating"></a>
<p><kbd>{C-j}</kbd> adds a new cell as a successor sibling of the
current cell, that is, the next cell at the same level as the current
cell.  If you enter a positive number as a prefix argument, that number
of cells will be inserted, all at the same level.  <kbd>{C-u C-j}</kbd> is
handled specially.  It adds a single cell as a child of the current cell.
<kbd>{C-c a}</kbd> does the same thing.  <kbd>{C-c p}</kbd> adds the cell as
the successor of the current cell&rsquo;s parent.
</p>
<a name="index-koutliner_002c-C_002dc-C_002dk"></a>
<a name="index-koutliner_002c-C_002dc-k"></a>
<a name="index-koutliner_002c-C_002du-C_002dc-k"></a>
<a name="index-koutliner_002c-C_002dy"></a>
<a name="index-cell_002c-killing"></a>
<a name="index-cell_002c-yanking-contents"></a>
<a name="index-tree_002c-killing"></a>
<p><kbd>{C-c C-k}</kbd> kills the current cell and its entire subtree.
<kbd>{C-c k}</kbd> kills the contents of a cell from point through the end
of the cell; it does not remove the cell itself.  <kbd>{C-u C-c k}</kbd>
kills the entire contents of the cell regardless of the location of
point.  You may then yank the contents into another cell or another
buffer with <kbd>{C-y}</kbd>.
</p>

<hr>
<a name="Relocating-and-Copying"></a>
<div class="header">
<p>
Next: <a href="#Moving-Around" accesskey="n" rel="next">Moving Around</a>, Previous: <a href="#Adding-and-Killing" accesskey="p" rel="prev">Adding and Killing</a>, Up: <a href="#Editing" accesskey="u" rel="up">Editing</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Relocating-and-Copying-1"></a>
<h4 class="subsection">6.5.2 Relocating and Copying</h4>

<a name="index-promotion"></a>
<a name="index-demotion"></a>
<a name="index-tree_002c-promoting"></a>
<a name="index-tree_002c-demoting"></a>
<p><em>Demotion</em> is the act of moving a tree down one or more levels in the
outline.  The new tree will become either the successor or the first
child of the cell which precedes it in the outline.  <em>Promotion</em> is
the inverse operation.  Note that trees (cells and their entire
substructure) are promoted and demoted, not individual cells.
</p>
<a name="index-koutliner_002c-TAB"></a>
<a name="index-koutliner_002c-M_002dTAB"></a>
<p>Trees may be demoted or promoted by pressing <tt class="key">TAB</tt> or
<kbd>{M-<span class="key">TAB</span>}</kbd> (or <kbd>{<span class="key">SHIFT</span>-<span class="key">TAB</span>}</kbd>) respectively, as in
most outliners today.  <kbd>{M-0 <span class="key">TAB</span>}</kbd> and <kbd>{M-0 M-<span class="key">TAB</span>}</kbd>
demote and promote trees and additionally refill each cell that is not
specially marked to prevent refilling.  See <a href="#Filling">Filling</a>.  A positive or
negative prefix argument to these commands promotes or demotes the tree
up to a maximum of the number of levels given by the argument.  The
outline may not support movement of the tree by the number of levels
requested, however, in which case the maximal possible adjustment is
made.
</p>
<a name="index-koutliner_002c-M_002d1-TAB"></a>
<a name="index-inserting-tabs"></a>
<a name="index-tabs_002c-inserting"></a>
<a name="index-kotl_002dmode_003aindent_002dtabs_002dmode"></a>
<a name="index-Koutliner_002c-toggle-tab-behavior"></a>
<p><kbd>{M-1 <span class="key">TAB</span>}</kbd> behaves specially.  It toggles the function of
<tt class="key">TAB</tt> and <kbd>{M-<span class="key">TAB</span>}</kbd> so that they insert a tab
and remove the previous character, respectively.  This is useful when
one is formatting information within a single cell.  When in this
mode, <kbd>{<span class="key">TAB</span>}</kbd> inserts a literal TAB character, by default.
Set the variable, <code>kotl-mode:indent-tabs-mode</code>, to
&lsquo;<samp>nil</samp>&rsquo; if you want space characters used to form the tab.
Use <kbd>{M-1 <span class="key">TAB</span>}</kbd> to toggle the <tt class="key">TAB</tt> and
<kbd>{M-<span class="key">TAB</span>}</kbd> keys back to promoting and demoting trees.
</p>
<a name="index-tree_002c-copying"></a>
<a name="index-tree_002c-moving"></a>
<a name="index-Action-Key_002c-cell-argument"></a>
<a name="index-koutliner_002c-Action-Key_002c-cell-argument"></a>
<p>For maximum flexibility in rearranging outlines, there are commands that
move or copy entire trees.  Each of these commands prompts for the label
of the root cell to move or copy and for a second cell which specifies
the new location for the moved or copied tree.  You may either accept
the default provided, type in the cell label, or when a mouse is
available, simply double click with the Action Key on the contents of a
cell.  The Koutliner knows to use the cell&rsquo;s label in such cases.
</p>
<p>In the following commands, words delimited with &lt;&gt; represent the
arguments for which each command prompts.  Note how the use of prefix
arguments changes each command&rsquo;s behavior from insertion at the sibling
level to insertion at the child level.
</p>
<dl compact="compact">
<dd><a name="index-C_002dc-c"></a>
</dd>
<dt><kbd>{C-c c}</kbd></dt>
<dd><p>Copy &lt;tree&gt; to be the successor of &lt;cell&gt;.
<a name="index-C_002du-C_002dc-c"></a>
</p></dd>
<dt><kbd>{C-u C-c c}</kbd></dt>
<dd><p>Copy &lt;tree&gt; to follow as the first child of &lt;cell&gt;.
</p>
<a name="index-C_002dc-C_002dc-1"></a>
</dd>
<dt><kbd>{C-c C-c}</kbd></dt>
<dd><p>Copy &lt;tree&gt; to be the predecessor of &lt;cell&gt;.
<a name="index-C_002du-C_002dc-C_002dc"></a>
</p></dd>
<dt><kbd>{C-u C-c C-c}</kbd></dt>
<dd><p>Copy &lt;tree&gt; to be the first child of the parent of &lt;cell&gt;.
</p>
<a name="index-C_002dc-m"></a>
</dd>
<dt><kbd>{C-c m}</kbd></dt>
<dd><p>Move &lt;tree&gt; to be the successor of &lt;cell&gt;.
<a name="index-C_002du-C_002dc-m"></a>
</p></dd>
<dt><kbd>{C-u C-c m}</kbd></dt>
<dd><p>Move &lt;tree&gt; to follow as the first child of &lt;cell&gt;.
</p>
<a name="index-C_002dc-C_002dm"></a>
</dd>
<dt><kbd>{C-c C-m}</kbd></dt>
<dd><p>Move &lt;tree&gt; to precede &lt;cell&gt;.
<a name="index-C_002du-C_002dc-C_002dm"></a>
</p></dd>
<dt><kbd>{C-u C-c C-m}</kbd></dt>
<dd><p>Move &lt;tree&gt; to be the first child of the parent of &lt;cell&gt;.
</p></dd>
</dl>

<a name="index-mouse_002c-moving-trees"></a>
<p>If you have mouse support under Hyperbole, you can move entire trees
with mouse clicks.  Click the Assist Key within the indentation to the
left of a cell and you will be prompted for a tree to move.  Double
click the Action Key within the contents of the root cell of the tree to
move and then double click within the root contents of the tree you want
it to follow as a sucessor.
</p>
<p>The Koutliner supports copying and moving within a single outline only
right now, so don&rsquo;t try to to move trees across different outline files.
You can, however, copy an outline tree to a non-outline buffer with:
</p>
<a name="index-tree_002c-exporting"></a>
<a name="index-outline_002c-exporting"></a>
<a name="index-tree_002c-mailing"></a>
<a name="index-outline_002c-mailing"></a>
<a name="index-exporting-an-outline"></a>
<a name="index-mailing-an-outline"></a>
<dl compact="compact">
<dd><a name="index-C_002dc-M_002dc"></a>
</dd>
<dt><kbd>{C-c M-c}</kbd></dt>
<dd><p>Copy a &lt;tree&gt; to a non-koutline buffer.
<a name="index-C_002dc-_0040"></a>
</p></dd>
<dt><kbd>{C-c @ }</kbd></dt>
<dd><p>Copy a &lt;tree&gt; to an outgoing mail message.
</p></dd>
</dl>

<a name="index-outline_002c-importing"></a>
<a name="index-copying"></a>
<p>You may also import cells into the current koutline from another
koutline with the <kbd>{M-x kimport:text <span class="key">RET</span>}</kbd> command.
See <a href="#Inserting-and-Importing">Inserting and Importing</a>.
</p>

<hr>
<a name="Moving-Around"></a>
<div class="header">
<p>
Next: <a href="#Filling" accesskey="n" rel="next">Filling</a>, Previous: <a href="#Relocating-and-Copying" accesskey="p" rel="prev">Relocating and Copying</a>, Up: <a href="#Editing" accesskey="u" rel="up">Editing</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Moving-Around-1"></a>
<h4 class="subsection">6.5.3 Moving Around</h4>

<a name="index-outline_002c-motion"></a>
<p>In addition to normal emacs movement commands, you can move within a
cell or from one cell or tree to another.
</p>
<dl compact="compact">
<dd><a name="index-C_002dc-_002c"></a>
</dd>
<dt><kbd>{C-c ,}</kbd></dt>
<dd><p>Move to the beginning of the current cell.
<a name="index-C_002dc-_002e-1"></a>
</p></dd>
<dt><kbd>{C-c .}</kbd></dt>
<dd><p>Move to the end of the current cell.
</p>
<a name="index-C_002dc-C_002dn"></a>
</dd>
<dt><kbd>{C-c C-n}</kbd></dt>
<dd><p>Move to the next visible cell, regardless of level.
<a name="index-C_002dc-C_002dp"></a>
</p></dd>
<dt><kbd>{C-c C-p}</kbd></dt>
<dd><p>Move to the previous visible cell, regardless of level.
</p>
<a name="index-C_002dc-C_002df"></a>
</dd>
<dt><kbd>{C-c C-f}</kbd></dt>
<dd><p>Move forward to this cell&rsquo;s successor, if any.
<a name="index-C_002dc-C_002db"></a>
</p></dd>
<dt><kbd>{C-c C-b}</kbd></dt>
<dd><p>Move backward to this cell&rsquo;s predecessor, if any.
</p>
<a name="index-C_002dc-C_002dd"></a>
</dd>
<dt><kbd>{C-c C-d}</kbd></dt>
<dd><p>Move to the first child of the current cell, if any.
<a name="index-C_002dc-C_002du"></a>
</p></dd>
<dt><kbd>{C-c C-u}</kbd></dt>
<dd><p>Move to the parent cell of the current cell, if any.
</p>
<a name="index-C_002dc-_003c"></a>
</dd>
<dt><kbd>{C-c &lt;}</kbd></dt>
<dd><p>Move to the first sibling at the current level within this tree.
<a name="index-C_002dc-_003e"></a>
</p></dd>
<dt><kbd>{C-c &gt;}</kbd></dt>
<dd><p>Move to the last sibling at the current level within this tree.
</p>
<a name="index-C_002dc-_005e"></a>
</dd>
<dt><kbd>{C-c ^}</kbd></dt>
<dd><p>Move to the level 1 root cell of the current tree.
<a name="index-C_002dc-_0024"></a>
</p></dd>
<dt><kbd>{C-c $}</kbd></dt>
<dd><p>Move to the last cell in the tree rooted at point, regardless of level.
</p></dd>
</dl>


<hr>
<a name="Filling"></a>
<div class="header">
<p>
Next: <a href="#Transposing" accesskey="n" rel="next">Transposing</a>, Previous: <a href="#Moving-Around" accesskey="p" rel="prev">Moving Around</a>, Up: <a href="#Editing" accesskey="u" rel="up">Editing</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Filling-1"></a>
<h4 class="subsection">6.5.4 Filling</h4>

<a name="index-outline_002c-filling"></a>
<a name="index-filling"></a>
<a name="index-word-wrap"></a>
<p><em>Filling</em> is the process of distributing words among lines to extend
short lines and to reduce long ones.  Commands are provided to fill a
paragraph within a cell or to fill a whole cell, which may have multiple
paragraphs.
</p>
<a name="index-filling-1"></a>
<a name="index-cell_002c-filling"></a>
<a name="index-paragraph_002c-filling"></a>
<a name="index-tree_002c-filling"></a>
<a name="index-margin"></a>
<a name="index-koutliner_002c-M_002dq"></a>
<a name="index-koutliner_002c-M_002dj"></a>
<a name="index-koutliner_002c-C_002dc-M_002dq"></a>
<a name="index-koutliner_002c-C_002dc-M_002dj"></a>
<a name="index-koutliner_002c-C_002dM_002dq"></a>
<a name="index-koutliner_002c-C_002dM_002dj"></a>
<p><kbd>{M-q}</kbd> or <kbd>{M-j}</kbd> refills a paragraph within a
cell so that its lines wrap within the current margin settings.
<kbd>{C-c M-q}</kbd> or <kbd>{C-c M-j}</kbd> refills all paragraphs within a
cell.  <kbd>{C-M-q}</kbd> or <kbd>{C-M-j}</kbd> refills all cells within a tree.
See the GNU Emacs manual for information on how to set the left and
right margins.
</p>
<a name="index-kotl_002dmode_003arefill_002dflag"></a>
<a name="index-refilling"></a>
<a name="index-attribute_002c-no_002dfill"></a>
<a name="index-cell_002c-no_002dfill-attribute"></a>
<p>Set the variable, <code>kotl-mode:refill-flag</code>, to &lsquo;<samp>t</samp>&rsquo; if you want
moving, promoting, demoting, exchanging, splitting and appending cells
to also automatically refill each cell.  Generally, this is not
recommended since if you happen to move a cell that you carefully
formatted yet forgot to give a &lsquo;no-fill&rsquo; property, then your formatting
will be lost.
</p>

<hr>
<a name="Transposing"></a>
<div class="header">
<p>
Next: <a href="#Splitting-and-Appending" accesskey="n" rel="next">Splitting and Appending</a>, Previous: <a href="#Filling" accesskey="p" rel="prev">Filling</a>, Up: <a href="#Editing" accesskey="u" rel="up">Editing</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Transposing-1"></a>
<h4 class="subsection">6.5.5 Transposing</h4>

<p>The Koutliner move and copy commands rearrange entire trees.  The
following two commands, in contrast, exchange the locations of two
individual cells.
</p>
<a name="index-koutliner_002c-C_002dc-e"></a>
<a name="index-cell_002c-transposing"></a>
<a name="index-cell_002c-exchanging"></a>
<a name="index-exchanging-cells"></a>
<a name="index-transposing-cells"></a>
<p><kbd>{C-c e}</kbd> prompts for two cell addresses and exchanges the cell
locations.
</p>
<a name="index-koutliner_002c-C_002dc-t"></a>
<p><kbd>{C-c t}</kbd> does not prompt.  It exchanges the current
and immediatly prior cell, regardless of their levels.  If there is no
prior cell it exchanges the current and next cell.
</p>
<a name="index-cell_002c-mark-and-point"></a>
<a name="index-koutliner_002c-M_002d0-C_002dc-t"></a>
<p><kbd>{M-0 C-c t}</kbd> exchanges the cells in which point and mark fall.
<kbd>{C-c t}</kbd> with a non-zero numeric prefix argument, N, moves
the current tree maximally past the next N visible cells.  If there are
fewer visible, it makes the current cell the last cell in the outline.
</p>

<hr>
<a name="Splitting-and-Appending"></a>
<div class="header">
<p>
Next: <a href="#Inserting-and-Importing" accesskey="n" rel="next">Inserting and Importing</a>, Previous: <a href="#Transposing" accesskey="p" rel="prev">Transposing</a>, Up: <a href="#Editing" accesskey="u" rel="up">Editing</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Splitting-and-Appending-1"></a>
<h4 class="subsection">6.5.6 Splitting and Appending</h4>

<a name="index-splitting-a-cell"></a>
<a name="index-cell_002c-splitting"></a>
<a name="index-koutliner_002c-C_002dc-s"></a>
<a name="index-koutliner_002c-C_002du-C_002dc-s"></a>
<p>One cell may be split into two adjacent sibling cells with <kbd>{C-c
s}</kbd>.  This leaves the cell contents preceding point in the current
cell, minus any trailing whitespace, and moves the contents following
point to a new sibling cell which is inserted into the outline.
<kbd>{C-u C-c s}</kbd> instead adds the new cell as the first child of the
original cell, rather than as its successor.
</p>
<p>All cell attributes in the original cell are propagated to the new one,
aside from the creation attributes and idstamp.
</p>
<a name="index-koutliner_002c-C_002dc-_002b"></a>
<a name="index-cell_002c-appending"></a>
<a name="index-appending-to-a-cell"></a>
<a name="index-attribute_002c-no_002dfill-1"></a>
<a name="index-cell_002c-no_002dfill-attribute-1"></a>
<p><kbd>{C-c +}</kbd> appends the contents of a specified cell to the end of
another cell.  It has no effect on cell attributes, except that if one
cell has a &lsquo;no-fill&rsquo; attribute, which prevents all but user requested
filling of a cell, then the cell appended to inherits this property.
This helps maintain any special formatting the appended text may have.
</p>
<hr>
<a name="Inserting-and-Importing"></a>
<div class="header">
<p>
Next: <a href="#Exporting" accesskey="n" rel="next">Exporting</a>, Previous: <a href="#Splitting-and-Appending" accesskey="p" rel="prev">Splitting and Appending</a>, Up: <a href="#Editing" accesskey="u" rel="up">Editing</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Inserting-and-Importing-1"></a>
<h4 class="subsection">6.5.7 Inserting and Importing</h4>

<a name="index-outline_002c-inserting-into"></a>
<a name="index-outline_002c-importing-into"></a>
<a name="index-importing"></a>
<a name="index-insertion"></a>
<a name="index-koutliner_002c-C_002dx-i"></a>
<a name="index-outline_002c-foreign-file"></a>
<p>The paragraphs of another buffer or file may be inserted into a koutline
as a set of cells by using the <kbd>{C-x i}</kbd> command.  When prompted,
you may use a buffer name or filename from which to insert;
completion is provided for filenames only.
</p>
<a name="index-koutliner_002c-C_002du-C_002dx-i"></a>
<p>The elements from the original buffer are converted into kcells and
inserted as the successors of the current cell.  If <kbd>{C-u C-x i}</kbd>
is used, they are instead inserted as the initial children of the current
cell.
</p>
<a name="index-kimport_003amode_002dalist"></a>
<a name="index-kimport_003asuffix_002dalist"></a>
<a name="index-outline_002c-conversion"></a>
<a name="index-kotl_002dmode"></a>
<a name="index-outline-mode"></a>
<a name="index-koutline-mode"></a>
<a name="index-file_002c-importing"></a>
<a name="index-importing-a-file"></a>
<p>For information on mode and suffix-specific conversions performed on
file elements before they are inserted, see the documentation for the
variables, <code>kimport:mode-alist</code> and <code>kimport:suffix-alist</code>.  This
same conversion process applies if you invoke <kbd>{M-x kotl-mode
<span class="key">RET</span>}</kbd> in a non-koutline buffer or if you perform a generic file import
as described later in this section.
</p>
<a name="index-kimport_003ainsert_002dfile_002dcontents"></a>
<p>Use <kbd>{M-x kimport:insert-file-contents <span class="key">RET</span>}</kbd> to insert an
entire file into the current cell following point.
</p>
<a name="index-kimport_003afile"></a>
<p>The outliner supports conversion of three types of files into koutline
files.  You can import a file into an existing koutline,
following the tree at point, or can create a new koutline from the
imported file contents.  <kbd>{M-x kimport:file <span class="key">RET</span>}</kbd> selects the
importation type based on the buffer or filename suffix of the file to
import.
</p>
<a name="index-kotl_002dmode-1"></a>
<p>If you want to convert a buffer from some other mode into a koutline and
then want to save the converted buffer back to its original file,
thereby replacing the original format, use <kbd>{M-x kotl-mode <span class="key">RET</span>}</kbd>.
Remember that you will lose the old format of the buffer when you do
this.
</p>
<p>Use one of the following commands when you need explicit control over
the type of importation used on some text.  With these commands, your
original file remains intact.
</p>
<a name="index-kimport_003atext"></a>
<a name="index-text-file"></a>
<p>Use <kbd>{M-x kimport:text <span class="key">RET</span>}</kbd> and you will be prompted for a text
buffer or file to import and the new koutline buffer or file to create
from its text.  Each paragraph will be imported as a separate cell, with
all imported cells at the same level, since indentation of paragraphs is
presently ignored.  This same command can be used to import the
contents, attributes and level structure of cells from another koutline.
</p>
<a name="index-kimport_003astar_002doutline"></a>
<a name="index-emacs-outline"></a>
<a name="index-star-outline"></a>
<p>Star outlines are standard emacs outlines where each entry begins with
one or more asterisk characters.  Use <kbd>{M-x kimport:star-outline
<span class="key">RET</span>}</kbd> and you will be prompted for the star outline buffer or
file to import and the new koutline buffer or file to create.
</p>
<a name="index-Augment-outline"></a>
<a name="index-kimport_003aaug_002dpost_002doutline"></a>
<p>(Skip this if you are unfamiliar with the Augment/NLS system originally
created at SRI.)  Files exported from the Augment system as text often
have alphanumeric statement identifiers on the right side.  You can
import such files while maintaining their outline structure.  Use
<kbd>{M-x kimport:aug-post-outline <span class="key">RET</span>}</kbd> and you will be
prompted for the Augment buffer or file to import and the koutline to
create.
</p>
<hr>
<a name="Exporting"></a>
<div class="header">
<p>
Previous: <a href="#Inserting-and-Importing" accesskey="p" rel="prev">Inserting and Importing</a>, Up: <a href="#Editing" accesskey="u" rel="up">Editing</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Exporting-1"></a>
<h4 class="subsection">6.5.8 Exporting</h4>

<a name="index-outline_002c-exporting-from"></a>
<a name="index-outline_002c-HTML-conversion"></a>
<a name="index-exporting"></a>
<a name="index-HTML-conversion"></a>
<a name="index-kexport_003ahtml"></a>
<p>Koutlines may be <em>exported</em> to other file formats.  Presently, the
only format supported is conversion to HTML for publishing on the
World-Wide Web.
</p>
<p><kbd>{M-x kexport:html <span class="key">RET</span>}</kbd> prompts for the koutline buffer or
file to export, the HTML file or buffer to which to output, and the
title to use for the HTML file.  Completion of filenames is provided.
The conversion will then be done and the output file or buffer will be
written; the output file will not be displayed.
</p>

<hr>
<a name="Viewing"></a>
<div class="header">
<p>
Next: <a href="#Links" accesskey="n" rel="next">Links</a>, Previous: <a href="#Editing" accesskey="p" rel="prev">Editing</a>, Up: <a href="#Koutliner" accesskey="u" rel="up">Koutliner</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Viewing-1"></a>
<h3 class="section">6.6 Viewing</h3>

<a name="index-outline_002c-viewing"></a>
<a name="index-view"></a>
<p>The Koutliner has very flexible viewing facilities to allow you to
effectively browse and study large amounts of material.
</p>
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">&bull; <a href="#Hiding-and-Showing" accesskey="1">Hiding and Showing</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#View-Specs" accesskey="2">View Specs</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
</table>

<hr>
<a name="Hiding-and-Showing"></a>
<div class="header">
<p>
Next: <a href="#View-Specs" accesskey="n" rel="next">View Specs</a>, Previous: <a href="#Viewing" accesskey="p" rel="prev">Viewing</a>, Up: <a href="#Viewing" accesskey="u" rel="up">Viewing</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Hiding-and-Showing-1"></a>
<h4 class="subsection">6.6.1 Hiding and Showing</h4>

<a name="index-outline_002c-hiding"></a>
<a name="index-outline_002c-showing"></a>
<a name="index-collapsing"></a>
<a name="index-expanding"></a>
<a name="index-hiding"></a>
<a name="index-showing"></a>
<p>Individual cells, branches, or particular levels in the outline may be
hidden or shown.  These commands work even when an outline buffer is
read-only, e.g. when its file is not checked out of a version control
system yet, so that you can get effective views of an outline without
editing it.  Some of these commands affect the current view spec.
See <a href="#View-Specs">View Specs</a>.
</p>

<p>Here are the major commands for showing and hiding Koutline cells.
</p>
<dl compact="compact">
<dd><a name="index-hide-tree"></a>
<a name="index-tree_002c-show"></a>
<a name="index-C_002dc-C_002dh"></a>
</dd>
<dt><kbd>{C-c C-h}</kbd></dt>
<dd><p>Hide (collapse) the tree rooted at point.
<a name="index-show-tree"></a>
<a name="index-tree_002c-show-1"></a>
<a name="index-C_002dc-C_002ds"></a>
</p></dd>
<dt><kbd>{C-c C-s}</kbd></dt>
<dd><p>Show (expand) the tree rooted at point.
</p>
<a name="index-outline_002c-all-cells"></a>
<a name="index-cell_002c-show-all"></a>
<a name="index-C_002dc-C_002da"></a>
</dd>
<dt><kbd>{C-c C-a}</kbd></dt>
<dd><p>Show (expand) all of the cells in the outline.  With a prefix arg,
also toggle the display of blank lines between cells.
<a name="index-level"></a>
<a name="index-cell_002c-show-levels"></a>
<a name="index-outline_002c-show-levels"></a>
<a name="index-C_002dx-_0024"></a>
</p></dd>
<dt><kbd>{C-x $}</kbd></dt>
<dd><p>Show all of the cells down to a particular &lt;level&gt;.  You are prompted
for the level or a prefix argument may be given.
</p>
<a name="index-subtree_002c-hide"></a>
<a name="index-tree_002c-hide-subtree"></a>
<a name="index-cell_002c-hide-subtree"></a>
<a name="index-hide-subtree"></a>
<a name="index-C_002dM_002dh"></a>
</dd>
<dt><kbd>{C-M-h}</kbd></dt>
<dd><p>Hide the subtree at point, excluding the root cell.
<a name="index-subtree_002c-show"></a>
<a name="index-tree_002c-show-subtree"></a>
<a name="index-cell_002c-show-subtree"></a>
<a name="index-show-subtree"></a>
<a name="index-M_002dx-kotl_002dmode_003ashow_002dsubtree"></a>
</p></dd>
<dt><kbd>{M-x kotl-mode:show-subtree}</kbd></dt>
<dd><p>Show the subtree at point.  Use <kbd>{C-c C-s}</kbd> to achieve a similar
effect; the only difference is that it will additionally expand the root
cell.
</p>
<a name="index-overview"></a>
<a name="index-outline_002c-overview"></a>
<a name="index-C_002dc-C_002do"></a>
</dd>
<dt><kbd>{C-c C-o}</kbd></dt>
<dd><p>Show an overview of the outline by showing only the first line of
every cell.  With a prefix arg, also toggle the display of blank lines
between cells.
<a name="index-top_002dlevel-view"></a>
<a name="index-outline_002c-top_002dlevel"></a>
<a name="index-C_002dc-C_002dt"></a>
</p></dd>
<dt><kbd>{C-c C-t}</kbd></dt>
<dd><p>Show a top-level view of the outline by hiding all cells but those at
level 1 and collapsing the visible cells so that only their first lines
are visible.  With a prefix arg, also toggle the display of blank lines
between cells.
</p></dd>
</dl>

<a name="index-koutliner_002c-Action-Key_002c-hide-or-show-cell"></a>
<a name="index-Action-Key_002c-hide-or-show-cell"></a>
<a name="index-cell_002c-collapse"></a>
<a name="index-cell_002c-expand"></a>
<a name="index-koutliner_002c-M_002dRET"></a>
<p>A click or a press of the Action Key within a cell&rsquo;s body, but not on a
Hyperbole button, toggles between hiding and showing the tree rooted at
point.  Try it with either your mouse or with <kbd>{M-<span class="key">RET</span>}</kbd>.
</p>

<hr>
<a name="View-Specs"></a>
<div class="header">
<p>
Previous: <a href="#Hiding-and-Showing" accesskey="p" rel="prev">Hiding and Showing</a>, Up: <a href="#Viewing" accesskey="u" rel="up">Viewing</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="View-Specs-1"></a>
<h4 class="subsection">6.6.2 View Specs</h4>

<a name="index-view-spec"></a>
<a name="index-modeline_002c-view-spec"></a>
<a name="index-kvspec_003astring"></a>
<a name="index-pipe-character"></a>
<a name="index-_007c"></a>
<a name="index-_003c_007cviewspec_003e"></a>
<p><em>View specifications</em> (view specs, for short) are short codes used
to control the view of a koutline.  The view specs in effect for an
outline are always displayed in the modeline of the outline&rsquo;s window,
following the outline buffer name, unless the variable,
<code>kvspec:string</code>, has been set to &lsquo;<samp>nil</samp>&rsquo; to disable view spec
display.  The modeline display appears as &lt;|viewspec&gt; to aid rapid
visual location.  The | (pipe character) is also used in links that
specify view specs to indicate the start of a view spec sequence.
See <a href="#Links">Links</a>.
</p>
<a name="index-outline_002c-view-specs"></a>
<p>The current view spec is saved whenever the outline is saved.  The next
time the outline is read in, the same view spec will be applied.
</p>
<p>The rest of this section documents the view spec characters that are
presently supported and explains how to invoke a view spec.  There is no
user-level means of adding your own view spec characters, so all other
character codes are reserved for future use.
</p>
<a name="index-koutliner_002c-C_002dc-C_002dv"></a>
<a name="index-view-spec_002c-setting"></a>
<a name="index-view-spec_002c-changing"></a>
<a name="index-changing-the-view-spec"></a>
<a name="index-setting-the-view-spec"></a>
<p><kbd>{C-c C-v}</kbd> prompts for a new view spec setting in which the following
codes are valid.  Any invalid characters in a view spec are ignored.
Characters are evaluated in an order meant to do the right thing, even
when you use conflicting view spec characters.  The standard initial
view spec is &lt;|ben&gt;.
</p>
<a name="index-view-spec_002c-characters"></a>
<dl compact="compact">
<dd><a name="index-view-spec_002c-all-lines-and-levels"></a>
</dd>
<dt><kbd>a</kbd></dt>
<dd><p>Show all cell levels and all lines in cells.
</p>
<a name="index-koutliner_002c-C_002dc-b"></a>
<a name="index-blank-lines_002c-toggle"></a>
<a name="index-view-spec_002c-blank-lines"></a>
<a name="index-koutliner_002c-C_002dc-b-1"></a>
<a name="index-toggling-blank-lines"></a>
</dd>
<dt><kbd>b</kbd></dt>
<dd><p>Turn on blank lines between cells.  Without this character, blank lines
will be turned off.  You may also use the <kbd>{C-c b}</kbd> key binding to
toggle blank lines on and off independently of any other view settings.
</p>
<a name="index-view-spec_002c-lines-per-cell"></a>
<a name="index-hide-lines"></a>
<a name="index-collapse-lines"></a>
<a name="index-cutoff-lines"></a>
</dd>
<dt><kbd>cN</kbd></dt>
<dd><p>Hide any lines greater than N in each cell.  0 means don&rsquo;t cutoff any
lines.
</p>
<a name="index-ellipses"></a>
<a name="index-view-spec_002c-ellipses"></a>
</dd>
<dt><kbd>e</kbd></dt>
<dd><p>Show ellipses when some content of a cell or its subtree is hidden.
This cannot be turned off.
</p>
<a name="index-level-1"></a>
<a name="index-cell_002c-hiding-levels"></a>
<a name="index-hide-levels"></a>
<a name="index-view-spec_002c-show-levels"></a>
</dd>
<dt><kbd>lN</kbd></dt>
<dd><p>Hide cells at levels deeper than N.  0 means don&rsquo;t hide any cells.
</p>
<a name="index-label-type"></a>
<a name="index-view-spec_002c-label-type"></a>
<a name="index-kview_003adefault_002dlabel_002dtype"></a>
<a name="index-default-label-type"></a>
</dd>
<dt><kbd>n</kbd></dt>
<dd><p>Turn on the default label type, as given by the variable,
<code>kview:default-label-type</code>.  Normally, this is alphanumeric labels.
<a name="index-label-type_002c-idstamps"></a>
</p></dd>
<dt><kbd>n0</kbd></dt>
<dd><p>Display idstamps, e.g. 086.
<a name="index-label-type_002c-alpha-1"></a>
</p></dd>
<dt><kbd>n1</kbd></dt>
<dd><p>Display alpha labels, e.g. 1d3
<a name="index-label-type_002c-legal-1"></a>
</p></dd>
<dt><kbd>n.</kbd></dt>
<dd><p>Display legal labels, e.g. 1.4.3
</p></dd>
</dl>

<a name="index-view-spec_002c-example"></a>
<p>As a test, use <kbd>{C-h h k e}</kbd> to display the example koutline.
Then use <kbd>{C-c C-v}</kbd> to set a view spec of &lsquo;c2l1&rsquo;.  This will turn
off blank lines, clip each cell after its second line, and hide all
cells below level one.
</p>
<hr>
<a name="Links"></a>
<div class="header">
<p>
Next: <a href="#Cell-Attributes" accesskey="n" rel="next">Cell Attributes</a>, Previous: <a href="#Viewing" accesskey="p" rel="prev">Viewing</a>, Up: <a href="#Koutliner" accesskey="u" rel="up">Koutliner</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Links-1"></a>
<h3 class="section">6.7 Links</h3>

<a name="index-link"></a>
<a name="index-hyperlink"></a>
<a name="index-klink-1"></a>
<a name="index-_003c_003e-delimiters"></a>
<p>Cells may include hyperlinks that refer to other cells or to external
sources of information.  Explicit Hyperbole buttons may be created as
usual with mouse drags (see <a href="#By-Dragging">Creation Via Action Key
Drags</a>).  A <em>klink</em> is a special implicit link button, delimited by
&lt;&gt; separators, that jumps to a koutline cell.  This section discusses
klinks.
</p>
<a name="index-koutliner_002c-Action-Key_002c-klink"></a>
<a name="index-Action-Key_002c-klink"></a>
<a name="index-klink_002c-activating"></a>
<a name="index-klink-referent"></a>
<p>Press the Action Key over a klink to follow it.  This will flash the
klink as a button and then will display its referent in the other
window.  If the klink contains a view spec, it will be applied when
the referent is displayed.
</p>
<a name="index-klink_002c-inserting"></a>
<a name="index-koutliner_002c-C_002dc-l"></a>
<p>There are a number of easy ways to insert klinks into koutlines.  If you
have mouse support under Hyperbole, simply click the Action Key within
the indentation to the left of a cell text.  If you then double click on
some cell, a link to that cell will be inserted where you started.  From
a keyboard, use <kbd>{C-c l}</kbd> when in a koutline or <kbd>{C-h h k
l}</kbd> when not in a koutline to insert a klink.  Since klinks are
implicit buttons, you may instead type in the text of the klink just as
you see it in the examples below and it will work exactly as if it had
been entered with the insert link command.
</p>
<a name="index-klink_002c-formats"></a>
<p>There are basically three forms of klinks:
</p>
<dl compact="compact">
<dd><a name="index-internal-klink"></a>
<a name="index-klink_002c-internal"></a>
<a name="index-_003c_0040-klink_003e"></a>
</dd>
<dt><em>internal</em></dt>
<dd><p>&lsquo;<samp>&lt;@ 2b=06&gt;</samp>&rsquo; is an internal klink, since it refers to the koutline in
which it is embedded.  When activated, it jumps to the cell within the
current outline which has permanent id &lsquo;06&rsquo; and relative id
&lsquo;2b&rsquo;.  &lsquo;<samp>&lt;@ 06&gt;</samp>&rsquo; does the same thing, as does &lsquo;<samp>&lt;@ 2b&gt;</samp>&rsquo;,
though this latter form will not maintain the link properly if the
cell is moved elsewhere within the outline.  The form,
&lsquo;<samp>&lt;@ 2b=06 |ben&gt;</samp>&rsquo; additionally sets the view spec of the current
outline back to the default value, with a blank line between each cell
and the whole outline visible.
</p>
<a name="index-external-klink"></a>
<a name="index-klink_002c-external"></a>
</dd>
<dt><em>external</em></dt>
<dd><p>The second klink format is an external link to another koutline, such
as, &lsquo;<samp>&lt;EXAMPLE.kotl, 3=012 |c1e&gt;</samp>&rsquo;, which displays the named file,
starting at the cell 3 (whose permanent identifer is 012), with the
view specification of: blank lines turned off, cutoff after one line
per cell, and showing ellipses for cells or trees which are collapsed.
</p>
<a name="index-klink_002c-view-spec"></a>
<a name="index-view-spec-klink"></a>
</dd>
<dt><em>view spec</em></dt>
<dd><p>The third format sets a view spec for the current koutline.  For
example, &lsquo;<samp>&lt;|ben&gt;</samp>&rsquo;, when activated, sets the view in the current
outline to display blank lines, to use ellipses after collapsed lines
and to label cells with the alphanumeric style.
</p></dd>
</dl>

<hr>
<a name="Cell-Attributes"></a>
<div class="header">
<p>
Next: <a href="#Koutliner-History" accesskey="n" rel="next">Koutliner History</a>, Previous: <a href="#Links" accesskey="p" rel="prev">Links</a>, Up: <a href="#Koutliner" accesskey="u" rel="up">Koutliner</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Cell-Attributes-1"></a>
<h3 class="section">6.8 Cell Attributes</h3>

<a name="index-cell_002c-attribute"></a>
<a name="index-attribute"></a>
<p><em>Attributes</em> are named variables whose values are specific to an
outline cell.  Thus, each cell has its own attribute list.  Every cell
has three standard attributes:
</p>
<dl compact="compact">
<dd><a name="index-idstamp-attribute"></a>
</dd>
<dt><em>idstamp</em></dt>
<dd><p>The permanent id of the cell, typically used in cross-file hyperlinks
that reference the cell.
</p>
<a name="index-creator-attribute"></a>
<a name="index-e_002dmail-address-1"></a>
<a name="index-mail-address"></a>
</dd>
<dt><em>creator</em></dt>
<dd><p>The e-mail address of the person who created this cell.
</p>
<a name="index-create_002dtime-attribute"></a>
<a name="index-cell_002c-creation-time"></a>
</dd>
<dt><em>create-time</em></dt>
<dd><p>The time at which the cell was created.  This is stored in a form that
allows for easy data comparisons but is displayed in a human readable
format, such as &lsquo;<samp>Jan 28 18:27:59 CST 2021</samp>&rsquo;.
</p></dd>
</dl>

<a name="index-koutliner_002c-C_002dc-C_002di"></a>
<a name="index-attribute_002c-adding"></a>
<a name="index-attribute_002c-modifying"></a>
<a name="index-attribute_002c-removing"></a>
<p><kbd>{C-c C-i}</kbd> is the command to add an attribute to or to modify an
existing attribute of the cell at point.  Think of it as inserting an
attribute value.  To remove an attribute from a cell, set its value to
&lsquo;<samp>nil</samp>&rsquo;.
</p>

<a name="index-attribute_002c-no_002dfill-2"></a>
<a name="index-cell_002c-no_002dfill-attribute-2"></a>
<a name="index-no_002dfill-attribute"></a>
<p>The &lsquo;no-fill&rsquo; attribute is special.  When set to &lsquo;<samp>t</samp>&rsquo;, it
prevents movement, promotion, demotion, exchange, split or append
commands from refilling the cell, even if the variable,
<code>kotl-mode:refill-flag</code>, is set to &lsquo;<samp>t</samp>&rsquo;.  It does not prevent
you from invoking explicit commands that refill the cell.
See <a href="#Filling">Filling</a>.
</p>
<a name="index-koutliner_002c-Assist-Key_002c-listing-attributes"></a>
<a name="index-Assist-Key_002c-listing-attributes"></a>
<a name="index-listing-attributes"></a>
<a name="index-outline_002c-attribute-list"></a>
<a name="index-koutliner_002c-C_002dc-h"></a>
<a name="index-koutliner_002c-C_002du-C_002dc-h"></a>
<p>The attribute lists for the cells in the tree rooted at point may be
inspected by pressing the Assist Key within the contents of a cell.
<kbd>{C-c h}</kbd> prompts for a cell label and displays the cell&rsquo;s
attributes.  <kbd>{C-u C-c h}</kbd> prompts for a cell label and shows
the attributes for it and its subtree; use 0 as the kcell id to see
attributes for all visible cells in the outline.
</p>
<hr>
<a name="Koutliner-History"></a>
<div class="header">
<p>
Previous: <a href="#Cell-Attributes" accesskey="p" rel="prev">Cell Attributes</a>, Up: <a href="#Koutliner" accesskey="u" rel="up">Koutliner</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Koutliner-History-1"></a>
<h3 class="section">6.9 Koutliner History</h3>

<a name="index-NLS"></a>
<a name="index-Augment"></a>
<a name="index-Engelbart"></a>
<p>Much of the Hyperbole outliner design is based upon concepts pioneered
in the Augment/NLS system, <cite>[Eng84a]</cite>.  Augment treated documents as
a hierarchical set of nodes, called statements, rather than cells.
Every Augment document utilized this intrinsic structure.
</p>
<a name="index-distributed-collaboration"></a>
<a name="index-collaboration"></a>
<p>The system could rapidly change the view of a document by collapsing,
expanding, generating, clipping, filtering, including or reordering
these nodes.  It could also map individual views to multiple workstation
displays across a network to aid in distributed, collaborative work.
</p>
<a name="index-knowledge-transfer"></a>
<a name="index-idea-structuring"></a>
<a name="index-cross-referencing"></a>
<p>These facilities aided greatly in idea structuring, cross-referencing,
and knowledge transfer.  The Koutliner is a start at bringing
these capabilities back into the mainstream of modern computing culture.
</p>

<hr>
<a name="HyRolo"></a>
<div class="header">
<p>
Next: <a href="#Window-Configurations" accesskey="n" rel="next">Window Configurations</a>, Previous: <a href="#Koutliner" accesskey="p" rel="prev">Koutliner</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="HyRolo-1"></a>
<h2 class="chapter">7 HyRolo</h2>

<a name="index-Rolo"></a>
<a name="index-HyRolo"></a>
<p>Hyperbole includes a complete, advanced rolo system, HyRolo, for
convenient management of hierarchical, record-oriented information.
Most often this is used for contact management but it can quickly be
adapted to most any record-oriented lookup task requiring fast retrieval.
</p>
<a name="index-rolo_002c-buttons-in"></a>
<p>Hyperbole buttons may be included within rolo records and then
manually activated whenever their records are retrieved in a search.
</p>
<p>The following subsections explain use and basic customization of this
tool.
</p>
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">&bull; <a href="#HyRolo-Concepts" accesskey="1">HyRolo Concepts</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#HyRolo-Menu" accesskey="2">HyRolo Menu</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#HyRolo-Searching" accesskey="3">HyRolo Searching</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#HyRolo-Keys" accesskey="4">HyRolo Keys</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#HyRolo-Settings" accesskey="5">HyRolo Settings</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
</table>

<hr>
<a name="HyRolo-Concepts"></a>
<div class="header">
<p>
Next: <a href="#HyRolo-Menu" accesskey="n" rel="next">HyRolo Menu</a>, Previous: <a href="#HyRolo" accesskey="p" rel="prev">HyRolo</a>, Up: <a href="#HyRolo" accesskey="u" rel="up">HyRolo</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="HyRolo-Concepts-1"></a>
<h3 class="section">7.1 HyRolo Concepts</h3>

<a name="index-rolo-file"></a>
<a name="index-rolo-entry"></a>
<p>HyRolo manages and searches rolo files.  A <em>rolo file</em> consists of
an optional header that starts and ends with a line of equal signs
(at least three equal signs starting at the beginning of a line),
followed by zero or more rolo records.  You must manually add a header
to any rolo file if you want it to have one.
</p>
<p>Here is an example of a simple rolo file.  The date at the end is
automatically added by HyRolo whenever a new record is added.
</p>
<div class="example">
<pre class="example">==================================================================
                          PERSONAL ROLO
&lt;Last-Name&gt;, &lt;First&gt;  &lt;Email&gt;        W&lt;Work#&gt;       F&lt;Fax#&gt;
==================================================================
*   Smith, John       &lt;js@hiho.com&gt; W708-555-2001  F708-321-1492
        Chief Ether Maintainer, HiHo Industries
        05/24/2020
</pre></div>

<p>We call rolo records, <em>entries</em>.  Entries begin with a delimiter
of one or more &lsquo;*&rsquo; characters at the beginning of a line.  Entries may
be arranged in a hierarchy, where child entries start with one more &lsquo;*&rsquo;
character than do their parents.  Top-level entries begin with a single
&lsquo;*&rsquo;.
</p>
<p>Beyond this initial delimiter, entries are completely free-form text.
It is best to use a &quot;lastname, firstname&quot; format, however, when adding
contact entries into a rolo.  Then HyRolo will automatically keep your
entries alphabetized as you enter them.  Then you can sort the entries
if you ever need.  This ordering is what the rolo will use if you
accept the default entry with which it prompts you when adding a new
entry.
</p>
<p>Any search done on the rolo scans the full text of each entry.  During
a search, the rolo file header separator lines and anything in between
are appended to the buffer of matched entries before any entries are
retrieved from the file.  Whenever an entry is matched, it and all of
its descendant entries are retrieved.  If your emacs version supports
textual highlighting, each search match is highlighted for quick,
visual location.
</p>
<p>For example, a search on &quot;Company&quot; could retrieve the following:
</p>
<div class="example">
<pre class="example">==================================================================
                        COMPANY ROLO
==================================================================
*    Company
**     Manager
***      Staffer
</pre></div>

<p>Thus, searching for Company retrieves all listed employees.
Searching for Manager turns up all Staffer entries.
</p>

<hr>
<a name="HyRolo-Menu"></a>
<div class="header">
<p>
Next: <a href="#HyRolo-Searching" accesskey="n" rel="next">HyRolo Searching</a>, Previous: <a href="#HyRolo-Concepts" accesskey="p" rel="prev">HyRolo Concepts</a>, Up: <a href="#HyRolo" accesskey="u" rel="up">HyRolo</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Rolo-Menu"></a>
<h3 class="section">7.2 Rolo Menu</h3>

<p>The Rolo submenu of the Hyperbole menu offers a full set of commands
for searching and maintaining a personal address book.  It looks like
so.
</p>
<div class="float"><a name="image_003aRolo-Menu"></a>

<img src="im/menu-rolo.png" alt="HyRolo Menu">
<div class="float-caption"><p><strong>Image 7.1: </strong>HyRolo Menu</p></div></div>
<a name="index-Rolo-menu"></a>
<a name="index-HyRolo-menu"></a>
<a name="index-menu_002c-HyRolo"></a>
<a name="index-menu_002c-Rolo-1"></a>
<a name="index-C_002dmouse_002d3-1"></a>
<a name="index-popup-menu_002c-HyRolo"></a>
<a name="index-popup-menu_002c-Rolo"></a>
<a name="index-menubar-menu_002c-HyRolo"></a>
<a name="index-menubar-menu_002c-Rolo"></a>
<p>The Rolo/ menu entry on the Hyperbole minibuffer menu provides the same
set of commands as the menubar and popup menus, with more concise labels.
<kbd>{C-mouse-3}</kbd> pops up the mode-specific menu in Emacs.  Experiment with
the menu or read the following sections explaining commands.
</p>
<p>The minibuffer Rolo/ menu offers the following commands:
</p>
<a name="index-Rolo-commands"></a>
<a name="index-HyRolo-commands"></a>
<a name="index-hyrolo_002dadd"></a>
<a name="index-hyrolo_002ddisplay_002dmatches"></a>
<a name="index-hyrolo_002dedit"></a>
<a name="index-hyrolo_002dkill"></a>
<a name="index-hyrolo_002dmail_002dto"></a>
<a name="index-hyrolo_002dsort"></a>
<a name="index-hyrolo_002dgrep"></a>
<a name="index-hyrolo_002dfgrep"></a>
<a name="index-hyrolo_002dword"></a>
<a name="index-hyrolo_002dyank"></a>
<div class="example">
<pre class="example">Menu Item       Command                 Description
=====================================================================
Add             hyrolo-add              Adds a hyrolo entry
Display         hyrolo-display-matches  Displays last matches again
Edit            hyrolo-edit             Edits an existing hyrolo entry
Info                                    Displays a hyrolo manual entry
Kill            hyrolo-kill             Deletes a hyrolo entry
Mail            hyrolo-mail             Mails to an address at point
Order           hyrolo-sort             Sorts all hyrolo levels
RegexFind       hyrolo-grep             Finds all entries containing
                                          a regular expression
StringFind      hyrolo-fgrep            Finds all entries containing
                                          a string (or logical
                                          expression)
WordFind        hyrolo-word             Finds all entries containing
                                          a string of whole words
Yank            hyrolo-yank             Inserts the first matching
                                          hyrolo entry at point
=====================================================================
</pre></div>

<p>A prefix argument used with any of the find commands listed above
limits the search to a maximum number of matches given by the argument.
The search is terminated whenever that number of matches is found.
</p>
<p>For any of the above commands that prompt for a name such as Edit or
Add (not the Find commands), you may use the form parent/child to
locate a child entry below a specific parent.  Hence, for a HyRolo which
looks like so:
</p>
<div class="example">
<pre class="example">*    Company
**     Manager
***      Staffer
</pre></div>

<p>you can refer to the Staffer entry with the following hierarchical
notation, Company/Manager/Staffer.  This hierarchical
notation is not used in search expressions since they search the
entire HyRolo anyway.  Thus, &quot;Staffer&quot; as a search pattern will find an entry
containing &quot;Staffer&quot; at any level in a hierarchy, like so:
</p>
<div class="example">
<pre class="example">***      Staffer
</pre></div>

<hr>
<a name="HyRolo-Searching"></a>
<div class="header">
<p>
Next: <a href="#HyRolo-Keys" accesskey="n" rel="next">HyRolo Keys</a>, Previous: <a href="#HyRolo-Menu" accesskey="p" rel="prev">HyRolo Menu</a>, Up: <a href="#HyRolo" accesskey="u" rel="up">HyRolo</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="HyRolo-Searching-1"></a>
<h3 class="section">7.3 HyRolo Searching</h3>

<a name="index-rolo-searching"></a>
<a name="index-searching_002c-rolo"></a>
<a name="index-menu-item_002c-RegexFind"></a>
<a name="index-menu-item_002c-WordFind"></a>
<a name="index-menu-item_002c-StringFind"></a>
<p>See <a href="#HyRolo-Menu">HyRolo Menu</a>, for the list of HyRolo search commands.  In this
section, the menu item names from the minibuffer menu are used to
refer to each command.
</p>
<p>The <code>RegexFind</code> menu item searches the rolo list for all entries 
which contain matches for a given regular expression.  The regular
expression syntax used is the same as the one used within Emacs
and across the GNU set of tools.  See <a href="http://www.gnu.org/software/emacs/manual/html_mono/emacs.html#Regexps">Syntax of Regular
Expressions</a> in <cite>the GNU Emacs Manual</cite>, for full documentation on this
format.
</p>
<p>The <code>WordFind</code> menu item locates full-word matches so that if you
search for &lsquo;<samp>product</samp>&rsquo;, it won&rsquo;t match to occurrences of
&lsquo;<samp>production</samp>&rsquo;.  It is also handy for more precise name matching.
</p>
<a name="index-logical-rolo-searches"></a>
<p>The <code>StringFind</code> menu item has two uses.  It can find all entry
matches for a string or can execute logical queries for more
precise matching.  The format of logical queries is explained here; a
simple parenthesis delimited prefix format is used with the following
logical operators.
</p>
<div class="example">
<pre class="example">Operator Name   Number of Arguments    Description
=====================================================================
and             two or more            Match entries with all args
or              two or more            Match entries with any args
xor             two or more            Match entries with 1 arg only
not             one                    Match entries without the arg
=====================================================================
</pre></div>


<p>For example:
</p>
<div class="example">
<pre class="example">(and Company (not Vice-President))
</pre></div>

<p>would match those entries for people associated with &lsquo;<samp>Company</samp>&rsquo; who
do not have &lsquo;<samp>Vice-President</samp>&rsquo; titles.
</p>
<p>The following example would provide a list of all people marked as
clients whose area codes are outside of 408 and all non-clients within
the 408 area code.  This could be useful after all clients within
the 408 area code have been contacted and you want to see who else
you should contact.
</p>
<div class="example">
<pre class="example">(xor 408- client)
</pre></div>


<hr>
<a name="HyRolo-Keys"></a>
<div class="header">
<p>
Next: <a href="#HyRolo-Settings" accesskey="n" rel="next">HyRolo Settings</a>, Previous: <a href="#HyRolo-Searching" accesskey="p" rel="prev">HyRolo Searching</a>, Up: <a href="#HyRolo" accesskey="u" rel="up">HyRolo</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="HyRolo-Keys-1"></a>
<h3 class="section">7.4 HyRolo Keys</h3>

<a name="index-hyrolo-menu"></a>
<a name="index-rolo-keys"></a>
<p>After a rolo search is performed, point is left in the <em>rolo
match buffer</em>, <samp>*Hyperbole Rolo*</samp>, which uses <code>hyrolo-mode</code> to
simplify browsing many rolo matches.  Press <kbd>{?}</kbd> when in the
match buffer for a summary of available keys, all of which are
documented in this section.
</p>
<a name="index-HyRolo_002c-see-rolo"></a>
<a name="index-rolo_002c-TAB"></a>
<a name="index-rolo_002c-M_002dTAB"></a>
<a name="index-rolo_002c-SHIFT_002dTAB"></a>
<a name="index-rolo_002c-r"></a>
<a name="index-rolo_002c-highlighting-matches"></a>
<a name="index-rolo_002c-finding-matches"></a>
<a name="index-rolo_002c-moving-through-matches"></a>
<p>If your emacs version supports textual highlighting, each search match
is highlighted for quick, visual location.  {<tt class="key">TAB</tt>} moves point
forward to successive spans of text which match the search expression.
<kbd>{M-<span class="key">TAB</span>}</kbd> <kbd>{<span class="key">SHIFT</span>-<span class="key">TAB</span>}</kbd> or <kbd>{r}</kbd> move
point backward to earlier matches.  These keys allow you to quickly
find the matching entry of most interest to you if your search
expression failed to narrow the matches sufficiently.
</p>
<a name="index-rolo_002c-M_002ds"></a>
<a name="index-rolo_002c-C_002ds"></a>
<a name="index-rolo_002c-C_002dr"></a>
<a name="index-rolo_002c-l"></a>
<a name="index-rolo_002c-extending-a-match"></a>
<a name="index-rolo_002c-interactive-searching"></a>
<a name="index-rolo_002c-locating-a-name"></a>
<p>If you want to extend the match expression with some more characters
to find a particular entry, use <kbd>{M-s}</kbd>.  This performs an
interactive search forward for the match expression.  You may add to
or delete characters from this expression to find different
occurrences or move to the next match with <kbd>{C-s}</kbd>.
<kbd>{C-r}</kbd> reverses the direction of the search.
</p>
<p>If you would like to search for a specific entry name in the match
buffer, use <kbd>{l}</kbd> to interactively locate the text immediately
following the entry start delimiter, typically one or more asterisks.
This lets you find entries by last name quickly, eliminating other
matches.  Standard string, <kbd>{C-s}</kbd>, and regular expression,
<kbd>{C-M-s}</kbd>, interactive search commands are also available within
the rolo match buffer.
</p>
<a name="index-rolo_002c-a"></a>
<a name="index-rolo_002c-h"></a>
<a name="index-rolo_002c-o"></a>
<a name="index-rolo_002c-s"></a>
<a name="index-rolo_002c-t"></a>
<a name="index-rolo_002c-outlining"></a>
<p>Single key outlining commands are also available for browsing matches.
If your search matches a large number of entries, use
<kbd>{t}</kbd> to get a top-level summary of entries.  Only the first
line of each first-level match is shown.  If you want to see an
overview of all the levels, use <kbd>{o}</kbd> which shows the first line
of every entry level.  If you want an overview of just the first two
levels, <kbd>{C-u 2 o}</kbd> will work.
</p>
<p>Press <kbd>{s}</kbd> to show (expand) the entry at point.
Use <kbd>{h}</kbd> to hide (collapse) the entry.  Press <kbd>{a}</kbd>
to expand all entries in the buffer.
</p>
<p>Many other keys are defined to help you move through matching entries.
</p>
<a name="index-rolo_002c-moving-to-entries"></a>
<dl compact="compact">
<dd><a name="index-rolo_002c-b"></a>
<a name="index-b-1"></a>
</dd>
<dt><kbd>{b}</kbd></dt>
<dd><p>Move to the previous entry at the same level as the current entry.
<a name="index-rolo_002c-f"></a>
<a name="index-f-1"></a>
</p></dd>
<dt><kbd>{f}</kbd></dt>
<dd><p>Move to the next entry at the same level as the current entry.
<a name="index-rolo_002c-n"></a>
<a name="index-n-1"></a>
</p></dd>
<dt><kbd>{n}</kbd></dt>
<dd><p>Move to the next entry at any level.
<a name="index-rolo_002c-p"></a>
<a name="index-p-1"></a>
</p></dd>
<dt><kbd>{p}</kbd></dt>
<dd><p>Move to the previous entry at any level.
<a name="index-rolo_002c-u"></a>
<a name="index-u-1"></a>
</p></dd>
<dt><kbd>{u}</kbd></dt>
<dd><p>Move to the previous entry one level up.
<a name="index-rolo_002c-_002e"></a>
<a name="index-rolo_002c-_003c"></a>
<a name="index-_002e-or-_003c"></a>
</p></dd>
<dt><kbd>{. or &lt;}</kbd></dt>
<dd><p>Move to the beginning of the buffer.
<a name="index-rolo_002c-_002c"></a>
<a name="index-rolo_002c-_003e"></a>
<a name="index-_002c-or-_003e"></a>
</p></dd>
<dt><kbd>{, or &gt;}</kbd></dt>
<dd><p>Move to the end of the buffer.
<a name="index-rolo_002c-DEL"></a>
<a name="index-DEL"></a>
</p></dd>
<dt><kbd>{<span class="key">DEL</span>}</kbd></dt>
<dd><p>Scroll backward a windowful.
<a name="index-rolo_002c-SPC"></a>
<a name="index-SPC"></a>
</p></dd>
<dt><kbd>{<span class="key">SPC</span>}</kbd></dt>
<dd><p>Scroll forward a windowful.
</p></dd>
</dl>

<a name="index-rolo_002c-e"></a>
<a name="index-rolo_002c-editing"></a>
<a name="index-datestamps"></a>
<a name="index-rolo_002c-datestamps"></a>
<a name="index-customize_002c-rolo-datestamps"></a>
<a name="index-menu_002c-Toggle_002dRolo_002dDates"></a>
<a name="index-customize_002c-rolo-edits"></a>
<a name="index-customize_002c-rolo-additions"></a>
<a name="index-hyrolo_002dedit_002dhook"></a>
<a name="index-hyrolo_002dadd_002dhook"></a>
<p>Use the <kbd>{e}</kbd> key to edit the current entry within your personal
rolo file.  A datestamp will automatically be added or updated at the end
of the entry, unless this feature has been turned off via the
Cust/Toggle-Rolo-Dates menu item.  The variable, <code>hyrolo-edit-hook</code>,
is evaluated after the update of the entry datestamp.  This allows
programmed modification of the way rolo edits work.  The variable,
<code>hyrolo-add-hook</code>, works the same way but is evaluated when a new
entry is first added.
</p>
<a name="index-rolo_002c-q"></a>
<a name="index-rolo_002c-quitting"></a>
<p>Once you have found an entry of interest and you want to remove the
rolo match buffer, use <kbd>{q}</kbd> to quit.  This will restore your
current frame to its state prior to the rolo search.
</p>
<hr>
<a name="HyRolo-Settings"></a>
<div class="header">
<p>
Previous: <a href="#HyRolo-Keys" accesskey="p" rel="prev">HyRolo Keys</a>, Up: <a href="#HyRolo" accesskey="u" rel="up">HyRolo</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="HyRolo-Settings-1"></a>
<h3 class="section">7.5 HyRolo Settings</h3>

<a name="index-hyrolo_002dfile_002dlist"></a>
<a name="index-rolo_002c-personal"></a>
<p>The files used in any rolo search are given by the
<code>hyrolo-file-list</code> variable, whose default value is
typically <code>(&quot;~/.rolo.otl&quot;</code>.  Searches scan only your
personal rolo file.  Any entries added to this list should be absolute
filenames.  If a file in the list does not exist or is not readable, it
is skipped.  Files are searched in the order in which they appear in the
list.  In general, you should leave your personal rolo file as the
first entry in the list, since this is the only file to which the Add
command on the rolo menu adds entries.
</p>
<p>Hyperbole releases earlier than 4.17 used a different filename for the
personal rolo.  If such a file exists, you will be prompted to rename
it whenever the HyRolo system is loaded.
</p>
<a name="index-BBDB"></a>
<a name="index-Big-Brother-DataBase"></a>
<p>If you use the Big Brother DataBase (BBDB) Emacs package to capture
email addresses and store contact information, the rolo automatically
works with it.  If the BBDB package is loaded before HyRolo, then your
<code>bbdb-file</code> of contacts is added as the second entry in
<code>hyrolo-file-list</code> and will be searched automatically for any matches by
the rolo find commands.  Presently there is no support for editing
BBDB entries, just finding them.
</p>
<p>For finding matches within only BBDB, there are the commands
<code>hyrolo-bbdb-fgrep</code> (string finding) and <code>hyrolo-bbdb-grep</code>
(regular expression finding).  They may be bound to keys if desired.
</p>
<a name="index-contacts_002c-Google"></a>
<a name="index-Google-Contacts"></a>
<a name="index-Gmail-Contacts"></a>
<p>If you use Google/Gmail Contacts, you can configure the HyRolo to
query your Google Contacts for matches.  First you must download and
install the external <samp>google-contacts</samp> package using the Emacs
Package Manager.  Then you must install the non-Emacs GNU Privacy
Guard (GPG) package from <a href="https://gnupg.org">https://gnupg.org</a> so that
the <samp>gpg</samp> or <samp>gpg2</samp> executable is in your command-line
search path.  Once these are in place, either restart Emacs or
use <kbd>{M-x hyrolo-initialize-file-list <span class="key">RET</span>}</kbd> to add Google
Contacts to your searches.
</p>
<p>When you next do a search, you will be prompted for your Google
Contacts password and may also have to enter an authorization code
that will be displayed on your screen.  After authorization, your
your information will be cached so that you are not prompted for
it again within this Emacs session.
</p>
<a name="index-hyrolo_002dgoogle_002dcontacts_002dfgrep"></a>
<a name="index-hyrolo_002dgoogle_002dcontacts_002dgrep"></a>
<p>For finding matches within only Google Contacts, there are the commands
<code>hyrolo-google-contacts-fgrep</code> (string finding) and
<code>hyrolo-google-contacts-grep</code> (regular expression finding).  They
may be bound to keys if desired.
</p>
<a name="index-hyrolo_002dgoogle_002dcontacts_002dflag"></a>
<p>If you ever need to disable Google Contacts usage, there is a
flag, <code>hyrolo-google-contacts-flag</code>, which when set to &lsquo;<samp>nil</samp>&rsquo;
disables searching of your Google Contacts.
</p>
<p>Below are the rest of the settings available with HyRolo:
</p>
<dl compact="compact">
<dd>
<a name="index-rolo_002c-highlighting-matches-1"></a>
</dd>
<dt><code>hyrolo-highlight-face</code>
<a name="index-hyrolo_002dhighlight_002dface"></a>
</dt>
<dd><p>If textual highlighting is available in your emacs on your current
display type, the rolo uses the value of <code>hyrolo-highlight-face</code> as
the face which highlights search matches.
</p>
</dd>
<dt><code>hyrolo-kill-buffers-after-use</code>
<a name="index-hyrolo_002dkill_002dbuffers_002dafter_002duse"></a>
</dt>
<dd><p>HyRolo file buffers are left around after they are searched, on the
assumption that another search is likely to follow within this emacs
session.  You may wish to change this behavior with the following
setting: <code>(setq hyrolo-kill-buffers-after-use t)</code>.
</p>
</dd>
<dt><code>hyrolo-save-buffers-after-use</code>
<a name="index-hyrolo_002dsave_002dbuffers_002dafter_002duse"></a>
</dt>
<dd><p>After an entry is killed, the modified rolo file is automatically
saved.  If you would rather always save files yourself, use this
setting: <code>(setq hyrolo-save-buffers-after-use nil)</code>.
</p>
</dd>
<dt><code>hyrolo-email-format</code>
<a name="index-hyrolo_002demail_002dformat"></a>
</dt>
<dd><p>When an entry is being added from within a mail reader buffer, the
rolo extracts the sender&rsquo;s name and e-mail address and prompts you
with the name as a default.  If you accept the default, it will enter
the name and the email address using the format given by the
<code>hyrolo-email-format</code> variable.  See its documentation if you want to
change its value.
</p>
</dd>
<dt><code>hyrolo-hdr-regexp</code>
<a name="index-hyrolo_002dhdr_002dregexp"></a>
</dt>
<dd><p>A rolo file may begin with an optional header section which is copied
to the match display buffer whenever any matches are found during a
search.  The start and end lines of this header are controlled by the
regular expression variable, <code>hyrolo-hdr-regexp</code>, whose default value
is &quot;^===&quot;.  This allows lines of all equal signs to visually separate
matching entries retrieved from multiple files during a single search.
</p>
</dd>
<dt><code>hyrolo-entry-regexp</code>
<a name="index-hyrolo_002dentry_002dregexp"></a>
</dt>
<dd><p>The rolo entry start delimiter is given by the regular expression
variable, <code>hyrolo-entry-regexp</code>, whose default value is &quot;^\*+&quot;, i.e. 
one or more asterisks at the beginning of a line.
</p>
</dd>
<dt><code>hyrolo-display-format-function</code>
<a name="index-hyrolo_002ddisplay_002dformat_002dfunction"></a>
</dt>
<dd><p>When a rolo search is done, each matching entry is passed through the
function given by the variable, <code>hyrolo-display-format-function</code>,
before it is displayed.  This should be a function of one argument,
namely the matching rolo entry as a string.  The string that this
function returns is what is displayed in the rolo match buffer.  The
default function used is <code>identity</code> which passes the string through
unchanged.  If you use the rolo code to search other kinds of
record-oriented data, this variable can be used to format each entry
however you would like to see it displayed.  With a little experience,
you can quickly write functions that use local bindings of the rolo
entry and file settings to search all kinds of record-oriented data.
There is never a need to learn a complicated query language.
</p>
</dd>
</dl>

<hr>
<a name="Window-Configurations"></a>
<div class="header">
<p>
Next: <a href="#Developing-with-Hyperbole" accesskey="n" rel="next">Developing with Hyperbole</a>, Previous: <a href="#HyRolo" accesskey="p" rel="prev">HyRolo</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Window-Configurations-1"></a>
<h2 class="chapter">8 Window Configurations</h2>

<a name="index-window-configurations"></a>
<a name="index-restoring-windows"></a>
<a name="index-saving-window-configurations"></a>
<a name="index-file_002c-hywconfig_002eel"></a>
<p>This chapter explains Hyperbole&rsquo;s <samp>hywconfig.el</samp> library.  It lets you
save and restore window configurations, i.e. the layout of windows and
buffers displayed within an emacs frame.  This is useful to save a
particular working context and then to jump back to it at a later time
during an emacs session.  It is also useful during demonstrations to
display many informational artifacts all at once, e.g. all of the windows
for a particular subsystem.  None of this information is stored between
emacs sessions, so your window configurations will last through only a
single session of use.  Each window configuration is tied to the emacs
frame in which it is created.
</p>
<p>The hywconfig library offers two independent ways of managing window
configurations.  The first way associates a name with each stored
window configuration.  The name may then be used to retrieve the window
configuration later.  The second way uses a ring structure to save
window configurations and then allows cycling through the ring of
saved configurations, finally wrapping around to the first entry after
the last entry is encountered.  Simply stop when the desired
configuration is displayed.
</p>
<p>The Win/ menu entry on the Hyperbole top-level menu displays a menu of
hywconfig window configuration commands:
</p>
<pre class="verbatim">WinConfig&gt;  AddName  DeleteName  RestoreName  PopRing  SaveRing  YankRing
</pre>
<p>The operations on this menu are defined as follows.
</p>
<a name="index-hywconfig-commands"></a>
<a name="index-wconfig-commands"></a>
<a name="index-window-configuration-commands"></a>
<a name="index-named-window-configuration"></a>
<a name="index-window-configuration-ring"></a>
<a name="index-hywconfig_002dadd_002dby_002dname"></a>
<a name="index-hywconfig_002ddelete_002dby_002dname"></a>
<a name="index-hywconfig_002drestore_002dby_002dname"></a>
<a name="index-hywconfig_002ddelete_002dpop"></a>
<a name="index-hywconfig_002dring_002dsave"></a>
<a name="index-hywconfig_002dyank_002dpop"></a>
<div class="example">
<pre class="example">Menu Item       Command                     Description
=====================================================================
AddName         hywconfig-add-by-name       Name current wconfig
DeleteName      hywconfig-delete-by-name    Delete wconfig by name
RestoreName     hywconfig-restore-by-name   Restore wconfig by name

PopRing         hywconfig-delete-pop        Restore and delete wconfig
SaveRing        hywconfig-ring-save         Store wconfig to the ring
YankRing        hywconfig-yank-pop          Restore the next wconfig
=====================================================================
</pre></div>

<p>The easiest method to save and restore window configurations shown here is
by name, but it requires that you type the chosen name.  Instead, the ring
commands permit saves and restores using only the mouse.  Since the ring
commands are a bit more complex than their by-name counterparts, the
following paragraphs explain them in more detail.
</p>
<a name="index-kill_002dring"></a>
<p>HyWconfig creates a ring structure that operates just like the Emacs
<code>kill-ring</code> (see <a href="http://www.gnu.org/software/emacs/manual/html_mono/emacs.html#Kill-Ring">Kill Ring</a> in <cite>the GNU Emacs Manual</cite>) but its
elements are window configurations rather than text regions.  You can
add an element to the ring to save the current window configuration in
the selected frame.  After several elements are in the ring, you can
walk through all of them in sequence until the desired configuration
is restored.
</p>
<a name="index-hywconfig_002dring_002dsave-1"></a>
<p>SaveRing executes the <code>hywconfig-ring-save</code> command which
saves the current window configuration to the ring.
</p>
<a name="index-hywconfig_002dyank_002dpop-1"></a>
<p>YankRing executes the <code>hywconfig-yank-pop</code> command.  It restores
the window configuration currently pointed to within the ring.  It
does not delete this configuration from the ring but it does move the
pointer to the prior ring element.  Repeated calls to this command
thus restore successive window configurations until the ring pointer
wraps around.  Simply stop when a desired configuration appears and
use <kbd>{q}</kbd> to quit from the minibuffer menu.
</p>
<a name="index-hywconfig_002ddelete_002dpop-1"></a>
<p>PopRing calls the <code>hywconfig-delete-pop</code> command.  It is used to
restore a previously saved configuration and to delete it from the ring.
Simply stop when a desired configuration appears and use <kbd>{q}</kbd> to
quit from the minibuffer menu.
</p>
<a name="index-hywconfig_002dring_002dmax"></a>
<p>The maximum number of elements the ring can hold is set by the
<code>hywconfig-ring-max</code> variable whose default is 10.  Any saves beyond
this value will delete the oldest element in the ring before a new one
is added.
</p>
<hr>
<a name="Developing-with-Hyperbole"></a>
<div class="header">
<p>
Next: <a href="#Glossary" accesskey="n" rel="next">Glossary</a>, Previous: <a href="#Window-Configurations" accesskey="p" rel="prev">Window Configurations</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Developing-with-Hyperbole-1"></a>
<h2 class="chapter">9 Developing with Hyperbole</h2>

<p>This chapter is for people who wish to customize Hyperbole, to extend
it, or to develop other systems using Hyperbole as a base.  Most of it
requires a basic level of familiarity with Emacs Lisp, though new
implicit button types may be created with knowledge of only Emacs
regular expressions.
</p>

<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">&bull; <a href="#Hook-Variables" accesskey="1">Hook Variables</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Creating-Types" accesskey="2">Creating Types</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Explicit-Button-Technicalities" accesskey="3">Explicit Button Technicalities</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Encapsulating-Systems" accesskey="4">Encapsulating Systems</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Embedding-Hyperbole" accesskey="5">Embedding Hyperbole</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
</table>

<hr>
<a name="Hook-Variables"></a>
<div class="header">
<p>
Next: <a href="#Creating-Types" accesskey="n" rel="next">Creating Types</a>, Previous: <a href="#Developing-with-Hyperbole" accesskey="p" rel="prev">Developing with Hyperbole</a>, Up: <a href="#Developing-with-Hyperbole" accesskey="u" rel="up">Developing with Hyperbole</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Hook-Variables-1"></a>
<h3 class="section">9.1 Hook Variables</h3>

<a name="index-variables"></a>
<a name="index-hook-variables"></a>
<p>Hyperbole supplies a number of hook variables that allow you to adjust
its basic operations to meet your own needs, without requiring you to
change the code for those operations.
</p>
<a name="index-add_002dhook"></a>
<p>We find it best to always set the value of hook variables either to
&lsquo;<samp>nil</samp>&rsquo; or to a list of function names of no arguments, each of which
will be called in sequence when the hook is triggered.  If you use
the <code>add-hook</code> function to adjust the value of hooks, it will do
this automatically for you.
</p>
<p>Given the name of a function, a Hyperbole hook variable triggered within
that function has the same name as the function with a &lsquo;<samp>-hook</samp>&rsquo;
appended.  Hyperbole includes the following hook variables:
</p>
<dl compact="compact">
<dt><code>hyperbole-init-hook</code>
<a name="index-hyperbole_002dinit_002dhook"></a>
</dt>
<dd><p>For customization at Hyperbole initialization time.  Use this to load
any personal Hyperbole type definitions or key bindings you might have.
It is run after Hyperbole support code is loaded but before Hyperbole is
initialized, i.e. prior to keyboard and mouse bindings.
</p>
</dd>
<dt><code>action-key-depress-hook</code>
<a name="index-action_002dkey_002ddepress_002dhook"></a>
</dt>
<dt><code>assist-key-depress-hook</code>
<a name="index-assist_002dkey_002ddepress_002dhook"></a>
</dt>
<dd><p>Run after an Action or Assist Mouse Key depress is detected.
</p>
</dd>
<dt><code>action-key-release-hook</code>
<a name="index-action_002dkey_002drelease_002dhook"></a>
</dt>
<dt><code>assist-key-release-hook</code>
<a name="index-assist_002dkey_002drelease_002dhook"></a>
</dt>
<dd><p>Run after an Action or Assist Mouse Key release is detected, before
any associated action is executed.
</p>
<a name="index-hbut_003acurrent"></a>
</dd>
<dt><code>action-act-hook</code>
<a name="index-action_002dact_002dhook"></a>
</dt>
<dd><p>Run before each Hyperbole button activation.
The variable <code>hbut:current</code> contains the button to be activated when
this is run.
</p>
</dd>
<dt><code>ebut-create-hook</code>
<a name="index-ebut_002dcreate_002dhook"></a>
</dt>
<dd><p>Adds to the Hyperbole explicit button creation process.
</p>
</dd>
<dt><code>ebut-delete-hook</code>
<a name="index-ebut_002ddelete_002dhook"></a>
</dt>
<dd><p>Adds to the Hyperbole explicit button deletion process.
</p>
</dd>
<dt><code>ebut-modify-hook</code>
<a name="index-ebut_002dmodify_002dhook"></a>
</dt>
<dd><p>Executed when an explicit button&rsquo;s attributes are modified.
</p>
</dd>
<dt><code>hibtypes-begin-load-hook</code>
<a name="index-hibtypes_002dbegin_002dload_002dhook"></a>
</dt>
<dd><p>Executed prior to loading of standard Hyperbole implicit button types.
Used to load site-specific low priority implicit button types since
lowest priority ibtypes are loaded first.
</p>
</dd>
<dt><code>hibtypes-end-load-hook</code>
<a name="index-hibtypes_002dend_002dload_002dhook"></a>
</dt>
<dd><p>Executed after loading of standard Hyperbole implicit button types.
Used to load site-specific high priority implicit button types since
highest priority ibtypes are loaded last.
</p>
</dd>
<dt><code>htype-create-hook</code>
<a name="index-htype_002dcreate_002dhook"></a>
</dt>
<dd><p>Executed whenever a Hyperbole type (e.g. action type or implicit button
type) is added to the environment.
</p>
</dd>
<dt><code>htype-delete-hook</code>
<a name="index-htype_002ddelete_002dhook"></a>
</dt>
<dd><p>Executed whenever a type is deleted from the environment.
</p>
</dd>
<dt><code>kotl-mode-hook</code>
<a name="index-kotl_002dmode_002dhook"></a>
</dt>
<dd><p>Executed whenever a koutline is created or read in or when kotl-mode is
invoked.
</p>
</dd>
<dt><code>hyrolo-add-hook</code>
<a name="index-hyrolo_002dadd_002dhook-1"></a>
</dt>
<dd><p>Executed after the addition of a new rolo entry.
</p>
</dd>
<dt><code>hyrolo-display-hook</code>
<a name="index-hyrolo_002ddisplay_002dhook"></a>
</dt>
<dd><p>Executed when rolo matches are displayed.
</p>
</dd>
<dt><code>hyrolo-edit-hook</code>
<a name="index-hyrolo_002dedit_002dhook-1"></a>
</dt>
<dd><p>Executed after point is successfully moved to an entry to be edited.
</p>
</dd>
<dt><code>hyrolo-mode-hook</code>
<a name="index-hyrolo_002dmode_002dhook"></a>
</dt>
<dd><p>Executed when a rolo match buffer is created and put into hyrolo-mode.
</p>
<a name="index-yank_002c-reformatting"></a>
</dd>
<dt><code>hyrolo-yank-reformat-function</code>
<a name="index-hyrolo_002dyank_002dreformat_002dfunction"></a>
</dt>
<dd><p>A variable whose value may be set to a function of two arguments, START
and END, which give the region of the rolo entry yanked into the
current buffer by the hyrolo-yank command.  The function may reformat this
region to meet user-specific needs.
</p>
</dd>
</dl>

<p>Hyperbole also makes use of a number of standard Emacs hook variables.
</p>
<dl compact="compact">
<dd>
<a name="index-button-highlighting"></a>
</dd>
<dt><code>find-file-hook</code>
<a name="index-find_002dfile_002dhook"></a>
</dt>
<dd><p>This is called whenever a file is read into a buffer.  Hyperbole uses
it to highlight any buttons within files.
</p>
<a name="index-button-data-saving"></a>
</dd>
<dt><code>write-file-hooks</code>
<a name="index-write_002dfile_002dhooks"></a>
</dt>
<dd><p>This is called whenever a buffer is written to a file.  Hyperbole uses
it to save modified button attributes associated with any file from the
same directory as the current file.
</p>
<a name="index-mail-hooks"></a>
<a name="index-news-hooks"></a>
<p>Hyperbole mail and news facilities also utilize a number of Emacs hook
variables.  These hide button data and highlight buttons if possible.
See the Hyperbole files with &lsquo;mail&rsquo; and &lsquo;gnus&rsquo; in their names for
specific usage of such hooks.
</p></dd>
</dl>

<hr>
<a name="Creating-Types"></a>
<div class="header">
<p>
Next: <a href="#Explicit-Button-Technicalities" accesskey="n" rel="next">Explicit Button Technicalities</a>, Previous: <a href="#Hook-Variables" accesskey="p" rel="prev">Hook Variables</a>, Up: <a href="#Developing-with-Hyperbole" accesskey="u" rel="up">Developing with Hyperbole</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Creating-Types-1"></a>
<h3 class="section">9.2 Creating Types</h3>

<a name="index-type-definition"></a>
<a name="index-type-redefinition-1"></a>
<p>To define or redefine a single Hyperbole type, you may either:
</p>
<ul>
<li> <a name="index-C_002dM_002dx"></a>
<a name="index-eval_002ddefun"></a>
<a name="index-C_002dx-C_002de"></a>
<a name="index-eval_002dlast_002dsexp"></a>
move your Emacs point to within the type definition and use
<kbd>{C-M-x}</kbd> <code>(eval-defun)</code> (only works in Emacs Lisp mode);

</li><li> or move your point to the end of the last line of the type definition and
use <kbd>{C-x C-e}</kbd> <code>(eval-last-sexp)</code> (works in most modes).
</li></ul>

<a name="index-Hyperbole-types"></a>
<a name="index-class_002c-htype"></a>
<p>The functions from the &lsquo;<samp>htype</samp>&rsquo; class may be applied to any
Hyperbole types, if needed.
</p>
<a name="index-file_002c-hactypes_002eel"></a>
<a name="index-file_002c-hibtypes_002eel-1"></a>
<p>The following subsections explain the specifics of Hyperbole type
definitions which are beyond standard practice for Emacs Lisp programming.
See the definitions of the standard types in <samp>hactypes.el</samp>
and <samp>hibtypes.el</samp> for examples.
</p>
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">&bull; <a href="#Creating-Action-Types" accesskey="1">Creating Action Types</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Creating-Implicit-Button-Types" accesskey="2">Creating Implicit Button Types</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
</table>

<hr>
<a name="Creating-Action-Types"></a>
<div class="header">
<p>
Next: <a href="#Creating-Implicit-Button-Types" accesskey="n" rel="next">Creating Implicit Button Types</a>, Previous: <a href="#Creating-Types" accesskey="p" rel="prev">Creating Types</a>, Up: <a href="#Creating-Types" accesskey="u" rel="up">Creating Types</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Creating-Action-Types-1"></a>
<h4 class="subsection">9.2.1 Creating Action Types</h4>

<a name="index-actype_003acreate"></a>
<a name="index-file_002c-hactypes_002eel-1"></a>
<a name="index-file_002c-hbut_002eel"></a>
<p>New forms of explicit buttons may be created by adding new action types
to a Hyperbole environment.  The file, <samp>hactypes.el</samp>, contains
many examples of working action types.
</p>
<a name="index-action-type_002c-creation"></a>
<a name="index-defact"></a>
<a name="index-actype_003acreate-1"></a>
<p>An action type is created, i.e. loaded into the Hyperbole environment,
with the <code>(defact)</code> function (which is an alias for
<code>(actype:create)</code>).  The calling signature for this function is
given in its documentation; it is the same as that of <code>(defun)</code>
except that a documentation string is required.  An interactive
calling form is also required if the action type has formal parameters
and is to be used in explicit or global button definitions.  Implicit
buttons never use an action type&rsquo;s interactive form; however, it is
good practice to include an interactive form since the type creator
cannot know how users may choose to apply the type.
</p>
<p>An action type&rsquo;s parameters are used differently than those of a
function being called.  Its interactive calling form is used to prompt
for type-specific button attributes whenever an explicit button is
created.  The rest of its body is used when a button with this action
type is activated.  Then the button attributes together with the action
type body are used to form an action that is executed in response to the
button activation.  The action&rsquo;s result is returned to the action caller
unless it returns &lsquo;<samp>nil</samp>&rsquo;, in which case &lsquo;<samp>t</samp>&rsquo; is returned to the
caller to ensure that it registers the performance of the action.
</p>
<p>An action type body may perform any computation that uses Emacs Lisp and
Hyperbole functions.
</p>
<a name="index-interactive-form"></a>
<a name="index-interactive"></a>
<p>The interactive calling form for an action type is of the same form as
that of a regular Emacs Lisp function definition (see the
documentation for the Emacs Lisp <code>(interactive)</code> form
or see <a href="http://www.gnu.org/software/emacs/manual/html_mono/elisp.html#Interactive-Codes">Code Characters for &rsquo;interactive&rsquo;</a> in <cite>the GNU Emacs Lisp Reference Manual</cite>.  It may additionally use
Hyperbole command character extensions when the form is given as a
string.  Each such extension character <em>must</em> be preceded by a
plus sign, &lsquo;<samp>+</samp>&rsquo;, in order to be recognized, since such characters
may also have different standard interactive meanings.
</p>
<p>The present Hyperbole extension characters are:
</p>
<dl compact="compact">
<dd><a name="index-argument_002c-Info-node"></a>
<a name="index-interactive-cmd-char_002c-_002bI"></a>
</dd>
<dt><code>+I</code></dt>
<dd><p>Prompts with completion for an existing Info (filename)nodename.
</p>
<a name="index-argument_002c-kcell"></a>
<a name="index-argument_002c-koutline"></a>
<a name="index-interactive-cmd-char_002c-_002bK"></a>
</dd>
<dt><code>+K</code></dt>
<dd><p>Prompts for an existing kcell identifier, either a full outline level
identifier or a permanent idstamp.
</p>
<a name="index-argument_002c-klink"></a>
<a name="index-interactive-cmd-char_002c-_002bL"></a>
</dd>
<dt><code>+L</code></dt>
<dd><p>Prompts for a klink specification.  See the documentation for the function
<code>(kcell-view:reference)</code> for details of the format of a klink.
</p>
<a name="index-interactive-cmd-char_002c-_002bM"></a>
<a name="index-argument_002c-mail-message"></a>
</dd>
<dt><code>+M</code></dt>
<dd><p>Prompts for a mail message date and the filename in which it resides.
The mail parameters prompted for by this character code may change in
the future.
</p>
<a name="index-argument_002c-view-spec"></a>
<a name="index-interactive-cmd-char_002c-_002bV"></a>
</dd>
<dt><code>+V</code></dt>
<dd><p>Prompts for a Koutliner view specification string, with the current
view spec, if any, as a default.
</p>
<a name="index-argument_002c-Info-index-item"></a>
<a name="index-interactive-cmd-char_002c-_002bX"></a>
</dd>
<dt><code>+X</code></dt>
<dd><p>Prompts with completion for an existing Info index (filename)itemname.
</p>
</dd>
</dl>

<a name="index-class_002c-hargs"></a>
<a name="index-argument_002c-reading"></a>
<p>Arguments are read by the functions in Hyperbole&rsquo;s <code>hargs</code> class,
rather than the standard Lisp <code>read</code> functions, in order to allow
direct selection of arguments via the Action Key.
</p>
<p>If an action type create is successful, the symbol that Hyperbole uses
internally to reference the type is returned.  On failure, &lsquo;<samp>nil</samp>&rsquo; is
returned so that you may test whether or not the operation succeeds.
</p>
<p>Once you have defined an action type within your present Hyperbole
environment, you can create new explicit buttons which use it.  There is
no explicit button type beyond its action type, so no other work is
necessary.
</p>
<a name="index-actype_003adelete"></a>
<p>Call <code>(actype:delete)</code> to remove an action type from a Hyperbole
environment.  It takes a single parameter which should be the same type
symbol used in the type definition call (not the Hyperbole symbol
returned by the call).
</p>
<hr>
<a name="Creating-Implicit-Button-Types"></a>
<div class="header">
<p>
Previous: <a href="#Creating-Action-Types" accesskey="p" rel="prev">Creating Action Types</a>, Up: <a href="#Creating-Types" accesskey="u" rel="up">Creating Types</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Creating-Implicit-Button-Types-1"></a>
<h4 class="subsection">9.2.2 Creating Implicit Button Types</h4>

<p>Implicit buttons leverage the same action types used by explicit and
global buttons but each carries an additional implicit button type
that defines the contexts in which it is active, e.g. major modes or
surrounding text.  Once an implicit button type definition is loaded
into Hyperbole, the Action and Assist Keys automatically recognize all
buttons of that type.  The Action Key activates the buttons and the
Assist Key summarizes their behavior and attributes.  With a single
definition, you can bring your text to life, activating implicit
hyperbuttons in thousands of documents with no other effort.
</p>
<p>There are three ways to create new implicit button types; the first
two are meant to allow non-programmers to extend Hyperbole with
simplified types.
</p>
<dl compact="compact">
<dt><b>Action Button Link Types</b></dt>
<dd><p>The first is very simple but can create only link buttons with a
specific textual form, i.e. &lt;action-type button-text&gt;.
</p>
</dd>
<dt><b>Implicit Button Link Types</b></dt>
<dd><p>The second is also limited to link buttons and requires regular expression
knowledge; it allows for any string or regular expression button
delimiters and regular expression or function link specifications.
</p>
</dd>
<dt><b>Programmatic Implicit Button Types</b></dt>
<dd><p>The third requires ELisp programming knowledge but can create any implicit
button type.
</p></dd>
</dl>

<p>The sections below examine these three implicit button type creation
techniques.
</p>
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">&bull; <a href="#Action-Button-Link-Types" accesskey="1">Action Button Link Types</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Implicit-Button-Link-Types" accesskey="2">Implicit Button Link Types</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Programmatic-Implicit-Button-Types" accesskey="3">Programmatic Implicit Button Types</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
</table>

<hr>
<a name="Action-Button-Link-Types"></a>
<div class="header">
<p>
Next: <a href="#Implicit-Button-Link-Types" accesskey="n" rel="next">Implicit Button Link Types</a>, Previous: <a href="#Creating-Implicit-Button-Types" accesskey="p" rel="prev">Creating Implicit Button Types</a>, Up: <a href="#Creating-Implicit-Button-Types" accesskey="u" rel="up">Creating Implicit Button Types</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Action-Button-Link-Types-1"></a>
<h4 class="subsubsection">9.2.2.1 Action Button Link Types</h4>

<p>The simplest way to create a new implicit link type (from which any
number of buttons can be recognized within text) is to create an
<em>action button link type</em>.
</p>
<p>A call to the <code>defal</code> macro of the form:
</p>
<p><code>(defal TYPE LINK-EXPR &amp;optional DOC)</code>
</p>
<p>will create a Hyperbole action button link TYPE (an unquoted symbol)
whose buttons always take the form of: <code>&lt;TYPE link-text&gt;</code> where
<code>link-text</code> is substituted into LINK-EXPR as grouping 1 (wherever
%s or \\1 is found) to form the link referent that is displayed for
each button.  Hyperbole automatically creates a doc string for the
type but you can override this by providing an optional DOC string.
</p>
<p>When the Action Key is pressed in a buffer between the start and end
delimiters and the text in-between matches to TEXT-REGEXP, then the
button is activated and does one of four things with LINK-EXPR:
</p>
<ol>
<li> executes it as a brace-delimited key series;
</li><li> displays it in a web browser as a URL;
</li><li> displays it as a path (possibly with trailing colon-separated line and column numbers);
</li><li> invokes a function or action type of one argument, the button text sans the function name, to display it.
</li></ol>

<p>For example, if you use Python and have a &lsquo;<samp>PYTHONPATH</samp>&rsquo; environment
variable, then pressing <kbd>{C-x C-e}</kbd> <code>eval-last-sexp</code> after
this expression:
</p>
<p><code>(defal pylib &quot;${PYTHONPATH}/%s&quot;)</code>
</p>
<p>defines a new action button link type called âpylibâ whose buttons
take the form of:
</p>
<p><code>&lt;pylib PYTHON-LIBRARY-FILENAME&gt;</code>
</p>
<p>and display the associated Python libraries (typically Python source
files).  Optional colon separated line and column numbers may be given
as well.
</p>
<p>Therefore an Action Key press on:
</p>
<p><code>&lt;pylib string.py:5:7&gt;</code>
</p>
<p>would display the source for <samp>string.py</samp> (wherever it is
installed on your system) from the Python standard library with point
on the fifth line at the seventh character.
</p>
<p>See <a href="#Implicit-Button-Link-Types">Implicit Button Link Types</a>, for more flexible regular
expression-based link type creation.  See <a href="#Programmatic-Implicit-Button-Types">Programmatic Implicit Button Types</a>, for the most general implicit button type creation.
</p>
<hr>
<a name="Implicit-Button-Link-Types"></a>
<div class="header">
<p>
Next: <a href="#Programmatic-Implicit-Button-Types" accesskey="n" rel="next">Programmatic Implicit Button Types</a>, Previous: <a href="#Action-Button-Link-Types" accesskey="p" rel="prev">Action Button Link Types</a>, Up: <a href="#Creating-Implicit-Button-Types" accesskey="u" rel="up">Creating Implicit Button Types</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Implicit-Button-Link-Types-1"></a>
<h4 class="subsubsection">9.2.2.2 Implicit Button Link Types</h4>

<p>If you understand Emacs regular expressions (see <a href="http://www.gnu.org/software/emacs/manual/html_mono/emacs.html#Regexps">Syntax of
Regular Expressions</a> in <cite>the GNU Emacs Manual</cite>), you can create new
implicit button types without understanding how to program in Emacs
Lisp, aside from the instructions provided here.
</p>
<p>A call to the <code>defil</code> macro of the form:
</p>
<p><code>(defil TYPE START-DELIM END-DELIM TEXT-REGEXP LINK-EXPR
             &amp;optional START-REGEXP-FLAG END-REGEXP-FLAG DOC)</code>
</p>
<p>will create a new Hyperbole implicit button link TYPE (an uquoted
symbol), recognized in a buffer via START-DELIM and END-DELIM
(strings) and the TEXT-REGEXP pattern between the delimiters.  With
optional START-REGEXP-FLAG true, START-DELIM is treated as a regular
expression.  Similarly, a true value of END-REGEXP-FLAG treats
END-DELIM as a regular expression.  Hyperbole automatically creates a
doc string for the type but you can override this by providing an
optional DOC string.
</p>
<p>When the Action Key is pressed in a buffer between the start and end
delimiters and the text in-between matches to TEXT-REGEXP, then the
button is activated and does one of four things with LINK-EXPR:
</p>
<ol>
<li> executes it as a brace-delimited key series;
</li><li> displays it in a web browser as a URL;
</li><li> displays it as a path (possibly with trailing colon-separated line and column numbers);
</li><li> invokes a function or action type of one argument, the button text (sans the function name if an Action Button), to display it.
</li></ol>

<p>Prior to activation, for the first three kinds of LINK-EXPR, a
<code>replace-match</code> is done on the expression to generate the
button-specific referent to display.  Thus, either the whole button
text (&lsquo;<samp>\\&amp;</samp>&rsquo;) or any numbered grouping from TEXT-REGEXP,
e.g. &lsquo;<samp>\\1</samp>&rsquo;, may be referenced in the LINK-EXPR to form the
link referent.
</p>
<p>Here is a sample use case.  Let&rsquo;s create a button type whose whose
buttons perform a grep-like function over a current repo&rsquo;s git log
entries.  The buttons use this format: [&lt;text to match&gt;].
</p>
<p>The following defines the button type called <code>search-git-log</code> with a 
a key series action surrounded by braces:
</p>
<p><code>(defil search-git-log &quot;[&lt;&quot; &quot;&gt;]&quot; &quot;.*&quot; &quot;{M-: (hypb:fgrep-git-log \&quot;\\&amp;\&quot;) RET}&quot;)</code>
</p>
<p>or this simpler version skips the explicit text substitution (\\\\&amp;)
and instead uses the function that takes the button text as an argument:
</p>
<p><code>(defil search-git-log &quot;[&lt;&quot; &quot;&gt;]&quot; &quot;.*&quot; #âhypb:fgrep-git-log)</code>
</p>
<p>Place point after one of the above expressions and evaluate it with
<kbd>{C-x C-e}</kbd> <code>eval-last-sexp</code> to define the implicit button
type.  Then if you have cloned the Hyperbole repo and are in a
Hyperbole source buffer, an Action Key press on a button of the form:
</p>
<p><code>;; [&lt;test release&gt;]</code>
</p>
<p>will display one line per commit whose change set matches &rsquo;test
release&rsquo;.  An Action Key press on any such line will then display the
commit changes.
</p>

<hr>
<a name="Programmatic-Implicit-Button-Types"></a>
<div class="header">
<p>
Previous: <a href="#Implicit-Button-Link-Types" accesskey="p" rel="prev">Implicit Button Link Types</a>, Up: <a href="#Creating-Implicit-Button-Types" accesskey="u" rel="up">Creating Implicit Button Types</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Programmatic-Implicit-Button-Types-1"></a>
<h4 class="subsubsection">9.2.2.3 Programmatic Implicit Button Types</h4>

<a name="index-implicit-button-type"></a>
<a name="index-ibtype"></a>
<a name="index-defib"></a>
<a name="index-ibtype_003acreate"></a>
<p>An implicit button type is created or loaded via the <code>(defib)</code>
function (which is an alias for <code>(ibtype:create)</code>).  The calling
signature for this function is given in its documentation; it is the
same as that of <code>(defun)</code>, but with a number of constraints.  The
parameter list should always be empty since no parameters will be used.
A documentation string is required; it is followed by the body of the
type.
</p>
<a name="index-ibtype_002c-predicate"></a>
<a name="index-ibtype_002c-argument"></a>
<a name="index-ibtype_002c-return-val"></a>
<a name="index-ibtype_002c-actype"></a>
<p>The body of an implicit button type is a predicate which determines
whether or not point is within an implicit button of the type.  If not,
the predicate returns &lsquo;<samp>nil</samp>&rsquo;.  If so, it may optionally setup to
flash the button and then to perform one or more actions.  A call of the
form: <code>(ibut:label-set label start-pos end-pos)</code> is used to setup
the button flashing, if desired.  This is then typically immediately
followed by an action invocation of the form:
<code>(hact 'actype &amp;rest actype-arguments)</code> where <code>actype</code> is a
Hyperbole action type symbol or an Emacs Lisp function name or lambda;
<code>actype-arguments</code> are the arguments fed to the action invocation
when an implicit button of the type is activated.
</p>
<p>It is imperative that all actions (non-predicate code) be invoked
through the <code>(hact)</code> function or your ibtypes will not work
properly.  (Hyperbole first tests to see if any ibtype matches the
current context before activating any type, so it ensures that
<code>(hact)</code> calls are disabled during this testing.)  Any action
types used in the definition of an implicit button type may be created
before or after the definition, but obviously, must be defined before
any implicit buttons of the given type are activated; an error will
result, otherwise.
</p>
<p>If an implicit button type create is successful, the symbol that
Hyperbole uses internally to reference the type is returned.  On
failure, &lsquo;<samp>nil</samp>&rsquo; is returned so that you may test whether or not the
operation succeeds.  Implicit button type names and action type names
may be the same without any conflict.  In fact, such naming is
encouraged when an implicit button type is the exclusive user of an
action type.
</p>
<a name="index-ibtype_003adelete"></a>
<p>Call <code>(ibtype:delete)</code> to remove an implicit button type from a
Hyperbole environment.  It takes a single parameter which should be the
same type symbol used in the type definition call (not the Hyperbole
symbol returned by the call).  This will not delete the action type used
by the implicit button; that must be done separately.
</p>
<a name="index-ibtype_002c-help"></a>
<a name="index-ibut_003aat_002dp"></a>
<a name="index-class_002c-hattr"></a>
<a name="index-class_002c-hbut"></a>
<a name="index-file_002c-hib_002dkbd_002eel"></a>
<p>By default, a request for help on an implicit button will display the
button&rsquo;s attributes in the same manner as is done for explicit buttons.
For some implicit button types, other forms of help will be more
appropriate.  If an Emacs Lisp function is defined whose name is formed
from the concatenation of the type name followed by &lsquo;<samp>:help</samp>&rsquo;, e.g.
<code>my-ibtype:help</code>, it is used as the assist-action whenever the
Assist Key is pressed, to respond to requests for help on buttons of
that type.  Any such function should take a single argument of an
implicit button construct.  (This is what
<code>(ibut:at-p)</code> returns when point is within an implicit button
context.)  The button may be queried for its attributes using
functions from the &lsquo;<samp>hbut</samp>&rsquo; and &lsquo;<samp>hattr</samp>&rsquo; classes.  See
the <samp>hib-kbd.el</samp> file for an example of a custom help function.
</p>
<hr>
<a name="Explicit-Button-Technicalities"></a>
<div class="header">
<p>
Next: <a href="#Encapsulating-Systems" accesskey="n" rel="next">Encapsulating Systems</a>, Previous: <a href="#Creating-Types" accesskey="p" rel="prev">Creating Types</a>, Up: <a href="#Developing-with-Hyperbole" accesskey="u" rel="up">Developing with Hyperbole</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Explicit-Button-Technicalities-1"></a>
<h3 class="section">9.3 Explicit Button Technicalities</h3>
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">&bull; <a href="#Button-Label-Normalization" accesskey="1">Button Label Normalization</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Operational-and-Storage-Formats" accesskey="2">Operational and Storage Formats</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Programmatic-Button-Creation" accesskey="3">Programmatic Button Creation</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
</table>

<hr>
<a name="Button-Label-Normalization"></a>
<div class="header">
<p>
Next: <a href="#Operational-and-Storage-Formats" accesskey="n" rel="next">Operational and Storage Formats</a>, Previous: <a href="#Explicit-Button-Technicalities" accesskey="p" rel="prev">Explicit Button Technicalities</a>, Up: <a href="#Explicit-Button-Technicalities" accesskey="u" rel="up">Explicit Button Technicalities</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Button-Label-Normalization-1"></a>
<h4 class="subsection">9.3.1 Button Label Normalization</h4>
<a name="index-normalized-label"></a>
<a name="index-button-label-2"></a>
<a name="index-button-key"></a>
<a name="index-hbut_003alabel_002dto_002dkey"></a>
<p>Hyperbole uses a normalized form of button labels called button keys (or
label keys) for all internal operations.  See the documentation for the
function <code>(hbut:label-to-key)</code> for details of the normalization
process.  The normalized form permits Hyperbole to recognize buttons that
are the same but whose labels appear different from one another, due to
text formatting conventions.  For example, all of the following would
be recognized as the same button.
</p>
<div class="example">
<pre class="example">  &lt;(fake button)&gt;     &lt;( fake      button)&gt;

  Pam&gt;  &lt;(fake
  Pam&gt;    button)&gt;

  ;; &lt;(fake
  ;;   button)&gt;

  /* &lt;( fake      */
  /*    button )&gt; */
</pre></div>

<a name="index-hbut_003afill_002dprefix_002dregexps"></a>
<a name="index-fill_002dprefix"></a>
<a name="index-fill-prefix"></a>
<a name="index-button_002c-multiple-lines"></a>
<a name="index-button_002c-split-across-lines"></a>
<p>The last three examples demonstrate how Hyperbole ignores common fill
prefix patterns that happen to fall within the middle of a button label
that spans multiple lines.  As long as such buttons are selected with
point at a location within the label&rsquo;s first line, the button will be
recognized.  The variable <code>hbut:fill-prefix-regexps</code> holds the list
of fill prefixes recognized when embedded within button labels.  All
such prefixes are recognized (one per button label), regardless of the
setting of the Emacs variable, <code>fill-prefix</code>, so no user
intervention is required.
</p>
<hr>
<a name="Operational-and-Storage-Formats"></a>
<div class="header">
<p>
Next: <a href="#Programmatic-Button-Creation" accesskey="n" rel="next">Programmatic Button Creation</a>, Previous: <a href="#Button-Label-Normalization" accesskey="p" rel="prev">Button Label Normalization</a>, Up: <a href="#Explicit-Button-Technicalities" accesskey="u" rel="up">Explicit Button Technicalities</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Operational-and-Storage-Formats-1"></a>
<h4 class="subsection">9.3.2 Operational and Storage Formats</h4>

<a name="index-explicit-button-formats"></a>
<a name="index-explicit-button-storage"></a>
<a name="index-storage-manager"></a>
<a name="index-button-attributes-1"></a>
<a name="index-hbut_003acurrent-1"></a>
<p>Hyperbole uses a terse format to store explicit buttons and a more
meaningful one to show users and to manipulate during editing.  The
terse format consists solely of button attribute values whereas the edit
format includes an attribute name with each attribute value.  A button
in edit format consists of a Lisp symbol together with its attribute list
which holds the attribute names and values.  In this way, buttons may be
passed along from function to function simply by passing the symbol to
which the button is attached.  Most functions utilize the pre-defined
<code>hbut:current</code> symbol by default to store and retrieve the last
encountered button in edit format.
</p>
<a name="index-class_002c-hbdata"></a>
<a name="index-class_002c-ebut"></a>
<a name="index-class_002c-hbut-1"></a>
<p>The &lsquo;<samp>hbdata</samp>&rsquo; class handles the terse, stored format.  The
&lsquo;<samp>hbut</samp>&rsquo;, &lsquo;<samp>ebut</samp>&rsquo;, and &lsquo;<samp>ibut</samp>&rsquo; classes work with the
name/value format.  This separation permits the wholesale replacement of
the storage manager with another, with any interface changes hidden from
any Hyperbole client programming.
</p>
<hr>
<a name="Programmatic-Button-Creation"></a>
<div class="header">
<p>
Previous: <a href="#Operational-and-Storage-Formats" accesskey="p" rel="prev">Operational and Storage Formats</a>, Up: <a href="#Explicit-Button-Technicalities" accesskey="u" rel="up">Explicit Button Technicalities</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Programmatic-Button-Creation-1"></a>
<h4 class="subsection">9.3.3 Programmatic Button Creation</h4>

<a name="index-explicit-button_002c-programmatic-creation"></a>
<p>A common need when developing with Hyperbole is to create or to modify
explicit buttons without user interaction.  For example, an application
might require the addition of an explicit summary button to a file for
each new mail message a user reads that contains a set of keywords.  The
user could then check the summary file and jump to desired messages
quickly.
</p>
<a name="index-class_002c-ebut-1"></a>
<a name="index-file_002c-hbut_002eel-1"></a>
<a name="index-ebut_003acreate"></a>
<a name="index-ebut_003amap"></a>
<p>The Hyperbole class &lsquo;<samp>ebut</samp>&rsquo; supports programmatic access to explicit
buttons.  Examine it within the <samp>hbut.el</samp> file for full details.
</p>
<a name="index-ebut_003aprogram"></a>
<p>The simplest way to create explicit buttons programmatically is to
call <code>ebut:program</code>.  This generates an explicit button at point
from LABEL, ACTYPE (action type) and any optional ACTYYPE ARGS.
It inserts the LABEL text at point surrounded by &lt;( )&gt; delimiters, adding any
necessary instance number of the button after the LABEL.  ACTYPE may
be a Hyperbole action type name (from defact) or an Emacs Lisp
function, followed by a list of arguments for the actype, aside from
the button LABEL which is automatically provided as the first argument.
</p>
<p>For interactive explicit creation, use <code>hui:ebut-create</code> instead.
</p>
<p>The documentation for <code>(ebut:create)</code> explains the set of
attributes necessary to create an explicit button.  For operations over
the whole set of buttons within the visible (non-narrowed) portion of a
buffer, use the <code>(ebut:map)</code> function.
</p>

<hr>
<a name="Encapsulating-Systems"></a>
<div class="header">
<p>
Next: <a href="#Embedding-Hyperbole" accesskey="n" rel="next">Embedding Hyperbole</a>, Previous: <a href="#Explicit-Button-Technicalities" accesskey="p" rel="prev">Explicit Button Technicalities</a>, Up: <a href="#Developing-with-Hyperbole" accesskey="u" rel="up">Developing with Hyperbole</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Encapsulating-Systems-1"></a>
<h3 class="section">9.4 Encapsulating Systems</h3>

<a name="index-file_002c-hsys_002d_002a"></a>
<a name="index-Hyperbole_002c-system-encapsulation"></a>
<a name="index-system-encapsulation"></a>
<p>A powerful use of implicit button types is to provide a Hyperbole-based
interface to external systems.  The basic idea is to interpret patterns
output by the application as implicit buttons.
</p>
<p>See the <samp>hsys-*</samp> files for examples of how to do this.
Encapsulations are provided for the following systems (the systems
themselves are not included with Hyperbole):
</p>
<dl compact="compact">
<dt><em>World-Wide Web</em></dt>
<dd><p>The world-wide web system originally developed at CERN, that now spans
the Internet universe.  This is automatically loaded by Hyperbole so
that a press of the Action Key follows a URL.
</p></dd>
</dl>


<hr>
<a name="Embedding-Hyperbole"></a>
<div class="header">
<p>
Previous: <a href="#Encapsulating-Systems" accesskey="p" rel="prev">Encapsulating Systems</a>, Up: <a href="#Developing-with-Hyperbole" accesskey="u" rel="up">Developing with Hyperbole</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Embedding-Hyperbole-1"></a>
<h3 class="section">9.5 Embedding Hyperbole</h3>

<p>[NOTE: We have never done this ourselves, though we have done similar
things which leads us to infer that the task should not be difficult.]
</p>
<a name="index-Hyperbole-API"></a>
<a name="index-API"></a>
<a name="index-programming-interface"></a>
<a name="index-Hyperbole_002c-embedding"></a>
<p>The standard Hyperbole user interface has purposely been separated from
the Hyperbole backend to support the development of alternative
interfaces and the embedding of Hyperbole functionality within other
system prototypes.  The Hyperbole backend functionality that system
developers can make use of is called its Application Programming
Interface (API).  The API may be used to make server-based calls to
Hyperbole when Emacs is run as a non-interactive (batch) process, with
its input/output streams attached to another process.
</p>
<p>The public functions and variables from the following files may be
considered the present Hyperbole API:
</p>
<p><samp>hact.el</samp>, <samp>hargs.el</samp>, <samp>hbmap.el</samp>, <samp>hbut.el</samp>,
<samp>hhist.el</samp>, <samp>hmail.el</samp>, <samp>hmoccur.el</samp>, <samp>hpath.el</samp>,
<samp>htz.el</samp>, <samp>hypb.el</samp>, <samp>hyrolo.el</samp>, <samp>hyrolo-logic.el</samp>,
<samp>hywconfig.el</samp> and <samp>set.el</samp>.
</p>

<p>Note when looking at these files, that they are divided into sections
that separate one data abstraction (class) from another.  A line of
dashes within a class separates public parts of the class from the
private parts that follow the line.
</p>
<p>This API does not include the Hyperbole Koutliner, as it has been
designed for interactive use, rather than programmatic extensibility.
You are welcome, however, to study its code, below the
<samp>hyperbole-${hyperb:version}/kotl/</samp> directory.
</p>

<hr>
<a name="Glossary"></a>
<div class="header">
<p>
Next: <a href="#Setup" accesskey="n" rel="next">Setup</a>, Previous: <a href="#Developing-with-Hyperbole" accesskey="p" rel="prev">Developing with Hyperbole</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Glossary-1"></a>
<h2 class="appendix">Appendix A Glossary</h2>

<a name="index-glossary"></a>
<a name="index-definitions"></a>
<p>Concepts pertinent to operational usage of Hyperbole are defined here.
See <a href="http://www.gnu.org/software/emacs/manual/html_mono/emacs.html#Glossary">Glossary</a> in <cite>the GNU Emacs Manual</cite>,
if any emacs-related terms are unfamiliar to you.
</p>
<dl compact="compact">
<dt><b>Action</b></dt>
<dt><b>Button Action</b></dt>
<dd><p>An executable behavior associated with a Hyperbole button.  <em>Links</em>
are a specific class of actions which display existing entities, such as
files. See also <b>Action Type</b>.
</p>
</dd>
<dt><b>Action Button</b></dt>
<dd><p>An implicit button that uses a universal button syntax delimited by &lt;angle brackets&gt;
to invoke any available Hyperbole action type or Emacs Lisp function.  Alternatively,
if it is an Emacs Lisp variable name, its action is to display the variable value.
</p>
</dd>
<dt><b>Action Key</b></dt>
<dd><p>See <b>Smart Key</b>.
</p>
</dd>
<dt><b>Action Type</b></dt>
<dd><p>A behavioral specification for use within Hyperbole buttons.  Action
types usually contain a set of parameters which must be given values for
each button with which they are associated.  An action type together
with a set of values, called arguments, is an <em>action</em>.
<em>Actype</em> is a synonym for action type.
</p>
</dd>
<dt><b>Activation</b></dt>
<dd><p>A request to a Hyperbole button to perform its action.
Ordinarily the user presses a key which selects and activates a button.
</p>
</dd>
<dt><b>Argument</b></dt>
<dd><p>A button-specific value fed to a Hyperbole type specification when the
button is activated.
</p>
</dd>
<dt><b>Assist Key</b></dt>
<dd><p>See <b>Smart Key</b>.
</p>
</dd>
<dt><b>Attribute</b></dt>
<dd><p>A named parameter slot associated with a category or type of Hyperbole
button.  An <em>attribute value</em> is typically specific to a particular
button instance.
</p>
<a name="index-Augment-1"></a>
<a name="index-hypertext-1"></a>
<a name="index-interactive-computing"></a>
<a name="index-mouse"></a>
<a name="index-windows"></a>
<a name="index-hypertext-2"></a>
<a name="index-outline-processor"></a>
<a name="index-groupware"></a>
<a name="index-digital-signature"></a>
<a name="index-Engelbart-1"></a>
</dd>
<dt><b>Augment</b></dt>
<dd><p>The Augment system, originally named NLS, was a pioneering research and
production system aimed at augmenting human intellect and group knowledge
processing capabilities through integrated tools and organizational
development strategies.  This approach led to the invention of much of
interactive computing technology decades ahead of other efforts, including:
the mouse, chord keyboards, screen windows, true hypertext, outline
processors, groupware, and digitally signed documents.
See <a href="#References">References</a>, which cites several Douglas Engelbart papers on the
subject.  The Koutliner demonstrates a few of the concepts pioneered in
Augment.
</p>
</dd>
<dt><b>Buffer</b></dt>
<dd><p>An Emacs buffer is an editable or viewable text, possibly with special
formatting such as an outline or table.  It may also be attached to a
process, receiving and updating its text as the process handles
changing information.
</p>
</dd>
<dt><b>Button</b></dt>
<dd><p>A selectable Hyperbole construct which performs an action.  A button
consists of a set of attributes that includes: a textual label, a
category, a type and zero or more arguments.  <em>Explicit buttons</em>
also have creator, create time, last modifier, and last modifier time
attributes.
</p>
<p>Buttons provide user gateways to information.  Users see and
interact with button labels; the rest of the button attributes are
managed invisibly by Hyperbole and displayed only in response to user
queries.
</p>
</dd>
<dt><b>Button Activation</b></dt>
<dd><p>See <b>Activation</b>.
</p>
</dd>
<dt><b>Button Attributes</b></dt>
<dd><p>See <b>Attributes</b>.
</p>
</dd>
<dt><b>Button Data</b></dt>
<dd><p>Lists of button attribute values explicitly saved and managed by Hyperbole.
One list for each button created by Hyperbole.
</p>
</dd>
<dt><b>Button File, local</b></dt>
<dd><p>A per-directory file named <samp>HYPB</samp> that may be used to store any
buttons that link to files within the directory.  It may be displayed
via a menu selection whenever a user is within the directory.
</p>
</dd>
<dt><b>Button File, personal</b></dt>
<dd><p>A per-user file named <samp>HYPB</samp> that stores all global buttons for the
user and any other buttons used to navigate to other information spaces.
It may be displayed via a menu selection at any time.
</p>
</dd>
<dt><b>Button Key</b></dt>
<dd><p>A normalized form of a <b>button label</b> used internally by Hyperbole.
</p>
</dd>
<dt><b>Button Label</b></dt>
<dd><p>A text string that visually indicates a Hyperbole button location and
that serves as its name and unique identifier.  Within a buffer, buttons
with the same label are considered separate views of the same button and
so behave exactly alike.  Since button labels are simply text strings,
they may be embedded within any text to provide non-linear information
or operational access points.
</p>
</dd>
<dt><b>Button Selection</b></dt>
<dd><p>The act of designating a Hyperbole button upon which to operate.
Use the Action Key to select a button.
</p>
</dd>
<dt><b>Category</b></dt>
<dd><p>A class of Hyperbole buttons: implicit, explicit or global.
</p>
</dd>
<dt><b>Cell</b></dt>
<dd><p>See <code>Kcell</code>.
</p>
</dd>
<dt><b>Children</b></dt>
<dd><p>The set of koutline cells which share a common parent cell and thus, are one
level deeper than the parent.
</p>

</dd>
<dt><b>Class</b></dt>
<dd><p>A group of functions and variables with the same prefix in their names,
used to provide an interface to an internal or external Hyperbole
abstraction.
</p>
</dd>
<dt><b>Context</b></dt>
<dd><p>A programmatic or positional state recognized by Hyperbole.
We speak of Smart Key and implicit button contexts.  Both are typically
defined in terms of surrounding patterns within a buffer, but may be
defined by arbitrary Emacs Lisp predicates.
</p>
</dd>
<dt><b>Display</b></dt>
<dd><p>See <b>Screen</b>.
</p>
</dd>
<dt><b>Domain</b></dt>
<dd><p>The contexts in which an implicit button type may be found, i.e. where
its predicate is true.
</p>
</dd>
<dt><b>Drag</b></dt>
<dd><p>A mouse button press in one location and following release in another
location.
</p>
</dd>
<dt><b>Elink</b></dt>
<dt><b>link-to-ebut</b></dt>
<dd><p>An Action Button that links to an explicit button.  It begins with &lt;elink:
followed by an explicit button label, an optional ebut file and ends with a
closing &gt;.
</p>
</dd>
<dt><b>Environment</b></dt>
<dd><p>See <b>Hyperbole Environment</b>.
</p>
</dd>
<dt><b>Explicit Button</b></dt>
<dd><p>A button created and managed by Hyperbole, associated with a specific
action type.  By default, explicit buttons are delimited like
this &lsquo;<samp>&lt;(fake button)&gt;</samp>&rsquo;.  Direct selection is used to operate upon
an explicit button.
</p>
</dd>
<dt><b>Frame</b></dt>
<dd><p>An Emacs frame displays one or more Emacs windows and widgets
(menubars, toolbars, scrollbars).  Under a graphical window system,
this is a single window system window.  On a dumb terminal, only one
frame is visible at a time as each frame generally fills the whole
terminal display, providing a virtual screen capability.  Emacs
windows exist within a frame.
</p>
<a name="index-gbut_003afile"></a>
</dd>
<dt><b>Global Button</b></dt>
<dd><p>A Hyperbole button which is accessed by name rather than direct
selection.  Global buttons are useful when one wants quick access to
actions such as jumping to common file locations or for performing
sequences of operations.  One need not locate them since they are
always available by name, with full completion offered.  All global
buttons are stored in the file given by the variable <code>gbut:file</code>
and may be activated with the Action Key when editing this file.  By
default, this is the same as the user&rsquo;s personal button file.
</p>
</dd>
<dt><b>Glink</b></dt>
<dt><b>link-to-gbut</b></dt>
<dd><p>An Action Button that links to a global button.  It begins with &lt;glink:
followed by a global button label and then a closing &gt;.
</p>
</dd>
<dt><b>Global Button File</b></dt>
<dd><p>See <b>Button File, personal</b> and <b>Global Button</b>.
</p>
</dd>
<dt><b>Grid</b></dt>
<dd><p>See <b>Windows Grid</b>.
</p>
<a name="index-hbut_003amax_002dlen-1"></a>
<a name="index-hbut_003amax_002dlen"></a>
<p>The maximum length of a button label is limited by the variable
<code>hbut:max-len</code>.  If 0, there is no limit and searches for button
end delimiters can go as far as the end of the buffer.  Use the
function, <code>(hbut:max-len)</code>, to read the proper value.
</p>
<a name="index-run_002dhooks"></a>
</dd>
<dt><b>Hook Variable</b></dt>
<dd><p>A variable that permits customization of an existing function&rsquo;s
operation without the need to edit the function&rsquo;s code.  See also the
documentation for the function <code>(run-hooks)</code>.
</p>
</dd>
<dt><b>HyControl</b></dt>
<dd><p>HyControl, the Hyperbole window and frame control manager, offers
fast, single key manipulation of window and frame creation, deletion,
sizing, position and face zooming (enlarging/shrinking).
</p>
</dd>
<dt><b>Hyperbole</b></dt>
<dd><p>The flexible, programmable information management and viewing system
documented by this manual.  It utilizes a button-action model and supports
hypertextual linkages.  Hyperbole is all things to all people.
</p>
</dd>
<dt><b>Hyperbole Environment</b></dt>
<dd><p>A programmatic context within which Hyperbole operates.  This includes
the set of Hyperbole types defined and the set of Hyperbole code modules
loaded.  It does not include the set of accessible buttons.
Although the entire Emacs environment is available to Hyperbole, we do
not speak of this as part of the Hyperbole environment.
</p>
</dd>
<dt><b>Hypertext</b></dt>
<dd><p>A text or group of texts which may be explored in a non-linear fashion
through associative linkages embedded throughout the text.  Instead of
simply referring to other pieces of work, hypertext references when
followed actually take you to the works themselves.
</p>
</dd>
<dt><b>HyRolo</b></dt>
<dd><p>HyRolo, the Hyperbole record/contact manager, provides rapid lookup of
multi-line, hierarchically ordered free form text records.  It can
also lookup records from Google/GMail Contacts and the Big Brother
DataBase (BBDB) package.
</p>
</dd>
<dt><b>Ilink</b></dt>
<dt><b>link-to-ibut</b></dt>
<dd><p>An Action Button that links to another implicit button.  It begins with &lt;ilink:
followed by an implicit button label, an optional ibut file and ends with a
closing &gt;.
</p>
</dd>
<dt><b>Implicit Button</b></dt>
<dd><p>A button recognized contextually by Hyperbole.  Such buttons contain no
button data but may have an optional preceding label that looks like this:
&lsquo;<samp>&lt;[label]&gt;</samp>&rsquo;.  See also <b>implicit button type</b>.
</p>
</dd>
<dt><b>Implicit Button Type</b></dt>
<dd><p>A specification of how to recognize and activate implicit buttons of a
specific kind.  Implicit button types often utilize structure internal
to documents created and managed by tools other than Hyperbole, for
example, programming documentation.  <b>Ibtype</b> is a synonym for
implicit button type.  See also <b>system encapsulation</b>.
</p>
<a name="index-InfoDock"></a>
</dd>
<dt><b>InfoDock</b></dt>
<dd><p>InfoDock was an integrated productivity toolset for software engineers
and knowledge workers built atop XEmacs; it is no longer maintained or
updated.  An older version from 1999 may be found at
infodock.sf.net.
</p>
<p>InfoDock has much of the power of GNU Emacs, but with an
easier to use and more comprehensive menu-based user interface.  Most
objections people raise to using emacs have already been addressed in
InfoDock.  InfoDock was meant for people who wanted a complete,
pre-customized environment in one package.
</p>
</dd>
<dt><b>Instance Number</b></dt>
<dd><p>A colon prefaced number appended to the label of a newly created button
when the button&rsquo;s label duplicates the label of an existing button in
the current buffer.  This number makes the label unique and so allows
any number of buttons with the same base label within a single buffer.
</p>
</dd>
<dt><b>Jedi</b></dt>
<dd><p>See also <a href="https://tkf.github.io/emacs-jedi/latest/">https://tkf.github.io/emacs-jedi/latest/</a>.
</p>
<p>Jedi is a Emacs package for Python completion, definition and documentation lookup.
</p>
</dd>
<dt><b>Key Sequence</b></dt>
<dd><p>A single sequence of keys that can invoke an Emacs command.
</p>
</dd>
<dt><b>Key Series</b></dt>
<dd><p>A series of one or more Emacs key sequences delimited by braces that
Hyperbole processes when activated as an implicit button, as if the
keys were typed in by the user.
</p>
</dd>
<dt><b>Koutline</b></dt>
<dd><p>A hierarchically ordered grouping of cells which may be stored as a file
and viewed and edited as an outline.
</p>
</dd>
<dt><b>Koutliner</b></dt>
<dd><p>Koutliner, the Hyperbole outliner, is a powerful autonumbering outliner
with permanent hypertext anchors for easy hyperlinking and view
specs for rapid outline view alteration.
</p>
</dd>
<dt><b>Kcell</b></dt>
<dd><p>Cells or kcells are elements within koutlines.  Each cell may contain
textual and graphical contents, a relative identifier, a permanent
identifier and a set of attributes such as the user who created the cell
and the time of creation.  See also <b>Koutliner</b>.
</p>
</dd>
<dt><b>Link</b></dt>
<dd><p>A reference from a Hyperbole button to an existing (non-computed)
entity.  The referenced entity is called a <em>referent</em>.
Links are a subset of the types of actions that Hyperbole buttons
support.
</p>
</dd>
<dt><b>Local Button File</b></dt>
<dd><p>See <b>Button File, local</b>.
</p>
</dd>
<dt><b>Minibuffer Window</b></dt>
<dd><p>The one line window at the bottom of a frame where messages and prompts
are displayed.
</p>
</dd>
<dt><b>Minibuffer Menu</b></dt>
<dd><p>A Hyperbole menu displayed in the minibuffer window.  Each menu item
within a minibuffer menu begins with a different letter that can be used
to invoke the item (case doesn&rsquo;t matter).  Items that display other
menus end with a forward slash, &lsquo;<samp>/</samp>&rsquo;.
</p>
</dd>
<dt><b>Mouse Key</b></dt>
<dt><b>Mouse Button</b></dt>
<dd><p>See <b>Smart Key</b>.
</p>
</dd>
<dt><b>NLS</b></dt>
<dd><p>See <b>Augment</b>.
</p>
</dd>
<dt><b>Node</b></dt>
<dd><p>See <b>Link</b> or <b>Cell</b>.
</p>
</dd>
<dt><b>The OO-Browser</b></dt>
<dd><p>See also <a href="https://www.gnu.org/software/oo-browser">https://www.gnu.org/software/oo-browser</a>.
</p>
<p>The GNU OO-Browser is a multi-windowed, interactive object-oriented class
browser similar in use to the well-known Smalltalk browsers.  It runs
inside Emacs.  It is unique in a number of respects foremost of which is
that it works well with most major object-oriented languages in use today.
You can switch from browsing in one language to another in a few seconds.
It provides both textual views within an editor and graphical views under
the X window system and Windows.  It includes support for C, C++, Common
Lisp and its Object System (CLOS), Eiffel, Java, Objective-C, Python and
Smalltalk.
</p>
<p>Hyperbole provides the mouse support for the OO-Browser, providing Smart
Keys that utilize the OO-Browser&rsquo;s capabilities both when it is displayed
on screen and when editing code.
</p>
</dd>
<dt><b>Outline</b></dt>
<dd><p>See <b>Koutline</b>.
</p>
</dd>
<dt><b>Parent</b></dt>
<dd><p>Any koutline cell which has children.
</p>
</dd>
<dt><b>Predecessor</b></dt>
<dd><p>The previous same level koutline cell with the same parent.
</p>
</dd>
<dt><b>Predicate</b></dt>
<dd><p>A boolean (&lsquo;<samp>nil</samp>&rsquo; = false, non-nil = true = &lsquo;<samp>t</samp>&rsquo;) Lisp
expression typically evaluated as part of a conditional expression.
Implicit button types contain predicates that determine whether or not a
button of that type is to be found at point.
</p>
</dd>
<dt><b>Referent</b></dt>
<dd><p>See <b>Link</b>.
</p>
</dd>
<dt><b>Remote Pathname</b></dt>
<dd><p>A file or directory on a system not shared within the local area network.
The built-in Emacs library, <b>Tramp</b>, handles remote pathnames and
Hyperbole uses it to enable viewing and editing of remote paths of the form:
<samp>/&lt;protocol&gt;:&lt;user&gt;@&lt;host&gt;:&lt;path&gt;</samp> as well as web URLs.  Use the
Cust/Find-File-URLs menu option to enable this feature.
</p>
</dd>
<dt><b>Rolo</b></dt>
<dd><p>See <b>HyRolo</b>.
</p>
</dd>
<dt><b>Root Cell</b></dt>
<dd><p>A koutline cell which has cells below it at lower outline levels.  All
such cells share the same root cell.
</p>
<a name="index-Screen"></a>
</dd>
<dt><b>Screen</b></dt>
<dd><p>The total display area available to Emacs frames.  This may consist of
multiple physical monitors arranged into a single virtual display.
Screen edges are thus the outer borders of the virtual display.
</p>
<a name="index-Smart-Key-1"></a>
<a name="index-proportional-scrolling"></a>
<a name="index-scrolling"></a>
</dd>
<dt><b>Smart Key</b></dt>
<dd><p>A context-sensitive key used within Hyperbole and beyond.  There are
two Smart Keys, the Action Key and the Assist Key.  The Action Key
activates Hyperbole buttons and scrolls the current buffer line to the
top of the window when pressed at the end of a line.
</p>
<p>The Assist Key shows help for Hyperbole buttons and scrolls the
current line to the bottom of the window when pressed at the end of a
line.
</p>
<p>The <kbd>{C-h h d s}</kbd> Doc/SmartKeys menu item displays a full summary of
Smart Key capabilities.  See <a href="#Smart-Keys">Smart Keys</a>, for complete details.
</p>
</dd>
<dt><b>Smart Menus</b></dt>
<dd><p>Smart Menus are an older in-buffer menu system that worked on dumb
terminals and pre-dated Emacs&rsquo; own dumb terminal menu support.  They
are included with InfoDock (which is no longer maintained) and are not
available separately.  They are not a part of Hyperbole and are not
necesary for its use but are still supported by the Smart Keys.
</p>
</dd>
<dt><b>Source Buffer / File</b></dt>
<dd><p>The buffer or file within which a Hyperbole button is embedded.
</p>
</dd>
<dt><b>Subtree</b></dt>
<dd><p>All of the cells in a koutline which share the same root cell, excluding
the root cell.
</p>
</dd>
<dt><b>Successor</b></dt>
<dd><p>The next same level koutline cell which follows the current cell and
shares the same parent.
</p>
</dd>
<dt><b>System Encapsulation</b></dt>
<dd><p>Use of Hyperbole to provide an improved or consistent user
interface to another system.  Typically, implicit button types are
defined to recognize and activate button-type constructs managed by the
other system.
</p>
</dd>
<dt><b>Tramp</b></dt>
<dd><p>A remote file access library built-in to Emacs.  It uses secure
transfer and works with many types of hosts.  It allows you to use
remote pathnames that are accessible via Internet protocols just like
other pathnames, for example when finding a file.  Hyperbole
recognizes pathnames of the form,
<samp>/&lt;protocol&gt;:&lt;user&gt;@&lt;host&gt;:&lt;path&gt;</samp> and web URLs.
</p>
</dd>
<dt><b>Tree</b></dt>
<dd><p>The set of cells in a koutline that share a common root cell, including
the root cell.
</p>
</dd>
<dt><b>URL</b></dt>
<dd><p>A Universal Resource Locator specification used on the World-Wide web
to access documents and services via a multiplicity of protocols.
</p>
</dd>
<dt><b>View</b></dt>
<dd><p>A perspective on some information.  A view can affect the extent of the
information displayed, its format, modes used to operate on it, its
display location and so forth.
</p>
</dd>
<dt><b>View Spec</b></dt>
<dd><p>A terse (and to the uninitiated, cryptic) string that specifies a
particular view of a koutline or a link referent.  If a view spec is
active for a buffer, the view spec appears within the modeline like so,
&lt;|view spec&gt;.
</p>
</dd>
<dt><b>Window</b></dt>
<dd><p>An Emacs window displays a single Emacs buffer within a single frame.
Frames may contain many windows.
</p>
</dd>
<dt><b>Windows Grid</b></dt>
<dd><p>A feature of HyControl invoked with <kbd>{@}</kbd> which creates, lays out
and populates a grid of a specified size of new Emacs windows, e.g. 4 rows
by 3 columns, each displaying a different buffer chosen by a set of user
specifiable filters.
</p></dd>
</dl>

<hr>
<a name="Setup"></a>
<div class="header">
<p>
Next: <a href="#Global-Key-Bindings" accesskey="n" rel="next">Global Key Bindings</a>, Previous: <a href="#Glossary" accesskey="p" rel="prev">Glossary</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Setup-1"></a>
<h2 class="appendix">Appendix B Setup</h2>

<p>Hyperbole must be obtained and setup at your site before you can
use it.  Instructions are given below.  If you are using InfoDock
version 4.0.7 or higher, Hyperbole is pre-installed so you may skip
the installation instructions and simply continue with the
invocation instructions in this appendix.
</p>
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">&bull; <a href="#Installation" accesskey="1">Installation</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Invocation" accesskey="2">Invocation</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Customization" accesskey="3">Customization</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
</table>

<hr>
<a name="Installation"></a>
<div class="header">
<p>
Next: <a href="#Invocation" accesskey="n" rel="next">Invocation</a>, Previous: <a href="#Setup" accesskey="p" rel="prev">Setup</a>, Up: <a href="#Setup" accesskey="u" rel="up">Setup</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Installation-1"></a>
<h3 class="section">B.1 Installation</h3>

<a name="index-installation"></a>
<a name="index-obtaining-Hyperbole"></a>
<a name="index-Hyperbole_002c-obtaining-1"></a>
<p>Once you have Emacs set up at your site, GNU Hyperbole may be
installed by using the Emacs Package Manager.  If you are not familiar
with it, see <a href="http://www.gnu.org/software/emacs/manual/html_mono/emacs.html#Packages">Packages</a> in <cite>the GNU Emacs Manual</cite>.
</p>
<p>If you have Hyperbole installed and simply want to upgrade it, invoke
the Emacs Package Manager with <kbd>{M-x list-packages <span class="key">RET</span>}</kbd>,
then use the <kbd>{U}</kbd> key followed by the <kbd>{x}</kbd> key to upgrade all
out-of-date packages, Hyperbole among them.  Then skip the text below
and move on to the next section, see <a href="#Invocation">Invocation</a>.
</p>
<p>Otherwise, to download and install the Hyperbole package, you should add
several lines to your personal Emacs initialization file, <samp>~/.emacs</samp>.
(For further details, see <a href="http://www.gnu.org/software/emacs/manual/html_mono/emacs.html#Init-File">The Emacs Initialization File</a> in <cite>the GNU Emacs Manual</cite>).
</p>
<p>Below are the lines to add:
</p>
<div class="lisp">
<pre class="lisp">(require 'package)
;; Prevent double loading of libraries
(setq package-enable-at-startup nil)
(package-initialize)
(unless (package-installed-p 'hyperbole)
  (package-refresh-contents)	
  (package-install 'hyperbole))
(require 'hyperbole)
</pre></div>

<p>Now save the file and restart Emacs.  Hyperbole will then be
downloaded and compiled for use with your version of Emacs; give it a
minute or two.  You may see a bunch of compilation warnings but these
can be safely ignored.
</p>
<p>Now read the next section on Invocation.
</p>
<hr>
<a name="Invocation"></a>
<div class="header">
<p>
Next: <a href="#Customization" accesskey="n" rel="next">Customization</a>, Previous: <a href="#Installation" accesskey="p" rel="prev">Installation</a>, Up: <a href="#Setup" accesskey="u" rel="up">Setup</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Invocation-1"></a>
<h3 class="section">B.2 Invocation</h3>

<p>Once Hyperbole has been installed for use at your site and loaded into
your Emacs session, it is ready for use.  You will see a Hyperbole
menu on your menubar and <kbd>{C-h h}</kbd> will display a Hyperbole menu in
the minibuffer for quick keyboard or mouse-based selection.  Select an
item from this menu by typing the item&rsquo;s first letter.  Use <kbd>{q}</kbd>
to quit from the menu.
</p>
<p>You can invoke Hyperbole&rsquo;s commands in one of three ways:
</p>
<ul>
<li> use the Hyperbole entry on your menubar;

</li><li> <a name="index-hyperbole"></a>
type <kbd>{C-h h}</kbd> or <kbd>{M-x hyperbole <span class="key">RET</span>}</kbd> to display the Hyperbole minibuffer menu;

</li><li> use a specific Hyperbole command, for example, a press of
<kbd>{M-<span class="key">RET</span>}</kbd> on a pathname to display the associated file or
directory.
</li></ul>

<p>Use <kbd>{C-h h d d}</kbd> for an interactive demonstration of standard Hyperbole
button capabilities.
</p>
<p>Type <kbd>{C-h h k e}</kbd> for an interactive demonstration of the Koutliner,
Hyperbole&rsquo;s multi-level autonumbered hypertextual outliner.
</p>
<p>To try out HyControl, Hyperbole&rsquo;s interactive frame and window control
system, use <kbd>{C-h h s w}</kbd> for window control or <kbd>{C-h h s f}</kbd>
for frame control.  Pressing <kbd>{t}</kbd> switches between window and
frame control once in HyControl.  Hyperbole also binds <kbd>{C-c \}</kbd>
for quick access to HyControl&rsquo;s window control menu if it was not
already bound prior to Hyperbole&rsquo;s initialization.  A long video
demonstrating most of HyControl&rsquo;s features is available at
<a href="https://youtu.be/M3-aMh1ccJk">https://youtu.be/M3-aMh1ccJk</a>.
</p>
<a name="index-Info_002ddirectory_002dlist"></a>
<a name="index-hyperb_003adir"></a>
<a name="index-Hyperbole-manual"></a>
<p>The above are the best interactive ways to learn about Hyperbole.  The
Hyperbole Manual is a reference manual, not a simple introduction.  It
is included in the <samp>man/</samp> subdirectory of the Hyperbole package
directory in four forms:
</p>
<a name="index-Info-manual"></a>
<a name="index-Texinfo-manual"></a>
<a name="index-file_002c-man_002fhyperbole_002einfo"></a>
<a name="index-file_002c-man_002fhyperbole_002ehtml"></a>
<a name="index-file_002c-man_002fhyperbole_002epdf"></a>
<a name="index-file_002c-man_002fhyperbole_002etexi"></a>
<div class="example">
<pre class="example"><samp>man/hyperbole.info</samp>   - online Info browser version
<samp>man/hyperbole.html</samp>   - web HTML version
<samp>man/hyperbole.pdf</samp>    - printable version
<samp>man/hyperbole.texi</samp>   - source form
</pre></div>

<a name="index-C_002dh-h-d-i"></a>
<p>The Hyperbole package installation places the Info version of this
manual where needed and adds an entry for Hyperbole into the Info
directory under the Emacs category.  <kbd>{C-h h d i}</kbd> will let you
browse the manual.  Then use <kbd>{s}</kbd> to search for anything
throughout the manual.  For web browsing, point your browser
at <samp><code>${hyperb:dir}</code>/man/hyperbole.html</samp>, wherever the
Hyperbole package directory is on your system; often this
is: <samp>~/.emacs.d/elpa/hyperbole-${hyperb:version}/</samp>.
</p>
<p>Advanced users may want to continue on to the next section about
configuring Hyperbole&rsquo;s behavior.
</p>
<hr>
<a name="Customization"></a>
<div class="header">
<p>
Previous: <a href="#Invocation" accesskey="p" rel="prev">Invocation</a>, Up: <a href="#Setup" accesskey="u" rel="up">Setup</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Customization-1"></a>
<h3 class="section">B.3 Customization</h3>

<a name="index-menu_002c-Cust-1"></a>
<a name="index-configuration"></a>
<a name="index-customization"></a>
<p>Major Hyperbole user options may be set from the Customize submenu
below the Hyperbole menubar menu, as seen here.
</p>
<div class="float"><a name="image_003aCustomize-Menu"></a>

<img src="im/menu-customization.png" alt="Hyperbole Customize Menu">
<div class="float-caption"><p><strong>Image B.1: </strong>Hyperbole Customize Menu</p></div></div><br>

<p>Alternatively, the minibuffer-based menu, Cust/ may be used.
</p>
<a name="index-customization-1"></a>
<a name="index-option-setting"></a>
<a name="index-variable-setting"></a>
<p>Generally, you should not need to change anything other than these options.
However, if you like to customize your environment extensively, there
are many additional Hyperbole customization options that may be 
changed with the Emacs customization interface,
see <a href="http://www.gnu.org/software/emacs/manual/html_mono/emacs.html#Easy-Customization">Easy Customization Interface</a> in <cite>the GNU
Emacs Manual</cite>.  When you save any changes within this interface, the
changes are saved permanently to your personal Emacs initialization
file and are available in future Emacs sessions.
</p>
<a name="index-customize_002dbrowse"></a>
<a name="index-menu-item_002c-Cust_002fAll_002dOptions"></a>
<a name="index-C_002dh-h-c-a"></a>
<p>Use Cust/All-Options <kbd>{C-h h c a}</kbd> to display an expandable tree of
customizable Hyperbole options.  Hyperbole&rsquo;s customizations are
further grouped into several sub-categories, one for the Koutliner,
one for the HyRolo, etc.  You can select either an entire category or a
specfic option and they will appear in another window for editing.
Simply follow the instructions on screen and then press the &ldquo;Apply
and Save&rdquo; button to make any changes permanent.
</p>
<a name="index-customize_002dvariable"></a>
<p>If you know the name of the option you want to edit, you can edit it
at any time without going through the tree of options.  Use <kbd>{M-x
customize-variable <span class="key">RET</span>}</kbd> and then type the name of the variable
and press <tt class="key">RET</tt> to edit it.
</p>
<p>The following sections discuss the customization options most likely to
be of interest to users.
</p>
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">&bull; <a href="#Referent-Display" accesskey="1">Referent Display</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Internal-Viewers" accesskey="2">Internal Viewers</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#External-Viewers" accesskey="3">External Viewers</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Link-Variable-Substitution" accesskey="4">Link Variable Substitution</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Web-Search-Engines" accesskey="5">Web Search Engines</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Using-URLs-with-Find_002dFile" accesskey="6">Using URLs with Find-File</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Invisible-Text-Searches" accesskey="7">Invisible Text Searches</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Button-Colors" accesskey="8">Button Colors</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
</table>

<hr>
<a name="Referent-Display"></a>
<div class="header">
<p>
Next: <a href="#Internal-Viewers" accesskey="n" rel="next">Internal Viewers</a>, Previous: <a href="#Customization" accesskey="p" rel="prev">Customization</a>, Up: <a href="#Customization" accesskey="u" rel="up">Customization</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Referent-Display-1"></a>
<h4 class="subsection">B.3.1 Referent Display</h4>
<a name="index-hpath_003adisplay_002dwhere-1"></a>
<a name="index-referent-display"></a>
<a name="index-link-display"></a>
<a name="index-display-where"></a>
<a name="index-display-outside-Emacs"></a>
<a name="index-where-to-display"></a>
<a name="index-image-display"></a>
<a name="index-internal-display"></a>
<a name="index-external-display"></a>
<p>Hyperbole lets you control where link referents are displayed.  It also
permits setting a specific Emacs function or external program
to display them.  There are four categories of referents, each with
its own display setting, listed in decreasing order of priority.  All
of these variables are defined within <samp>hpath.el</samp>.
</p>
<div class="example">
<pre class="example">Referent Category             Variable Setting
========================================================================
Internal Image Display        hpath:native-image-suffixes
Internal Custom Display       hpath:internal-display-alist
External Display              hpath:external-display-alist
Internal Standard Display     hpath:display-where

</pre></div>

<p>Continue reading the next sections for information on how referents
are displayed internally and externally.
</p>
<hr>
<a name="Internal-Viewers"></a>
<div class="header">
<p>
Next: <a href="#External-Viewers" accesskey="n" rel="next">External Viewers</a>, Previous: <a href="#Referent-Display" accesskey="p" rel="prev">Referent Display</a>, Up: <a href="#Customization" accesskey="u" rel="up">Customization</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Internal-Viewers-1"></a>
<h4 class="subsection">B.3.2 Internal Viewers</h4>
<a name="index-hpath_003ainternal_002ddisplay_002dalist"></a>
<a name="index-file-display-function"></a>
<a name="index-display-function"></a>
<a name="index-internal-viewer"></a>
<a name="index-link_002c-display-function"></a>

<a name="index-internal-image-display"></a>
<a name="index-hpath_003anative_002dimage_002dsuffixes"></a>
<a name="index-internal-custom-display"></a>
<a name="index-hpath_003ainternal_002ddisplay_002dalist-1"></a>
<a name="index-internal-standard-display"></a>
<a name="index-hpath_003adisplay_002dwhere-2"></a>
<p>When given a filename to display, Hyperbole first checks if its suffix
is matched by <code>hpath:native-image-suffixes</code>.  If so and if the
function <code>image-mode</code> is defined, it uses that mode together with
the value of <code>hpath:display-where</code> to display the image within an
Emacs buffer.
</p>
<p>If no match is found, the <code>hpath:internal-display-alist</code> variable
is checked for a filename match.  Its value is an association list
whose elements are (&lt;file-name-regular-expression&gt;
. &lt;function-of-one-arg&gt;) pairs.  Any path whose name matches
a &lt;file-name-regular-expression&gt; will be displayed by calling the
associated &lt;function-of-one-arg&gt; with the filename as the argument.
The first regular expression that matches each filename is the one
used.  This can be used to format raw data files for convenient
display.
</p>
<p>By default, this setting handles the following types of files:
</p><dl compact="compact">
<dt><em>Audio Files</em></dt>
<dd><p>Major audio format files are played with the <code>play-sound-file</code> command.
</p></dd>
<dt><em>Info Manuals</em></dt>
<dd><p>Files with a <samp>.info</samp> suffix (may also be compressed) are displayed in the Info browser.
</p></dd>
<dt><em>RDB Files</em></dt>
<dd><p>Files with an <samp>.rdb</samp> suffix are displayed as relational databases using the RDB package
available with InfoDock.
</p></dd>
</dl>

<a name="index-menu_002c-Cust_002fReferents"></a>
<a name="index-C_002dh-h-c-r"></a>
<p>Links to standard files, those which don&rsquo;t match any special referent
category described earlier, are displayed in an Emacs window specified
by the <code>hpath:display-where</code> setting.  It may be changed with the
Cust/Referents <kbd>{C-h h c r}</kbd> menu.
</p>
<p>Available options are:
</p>
<dl compact="compact">
<dt><em>&bull; Any-Frame</em></dt>
<dd><p>Display in the selected window of another existing frame
</p></dd>
<dt><em>&bull; Current-Win</em></dt>
<dd><p>Display in the selected (current) window
</p></dd>
<dt><em>&bull; Diff-Frame-One-Win</em></dt>
<dd><p>Display in the selected window of another existing frame, deleting its other windows
</p></dd>
<dt><em>&bull; New-Frame</em></dt>
<dd><p>Display in a new single window frame
</p></dd>
<dt><em>&bull; Other-Win</em></dt>
<dd><p>Display in another, possibly new window of the selected frame (this is
the default)
</p></dd>
<dt><em>&bull; Single-Win</em></dt>
<dd><p>Display in a window of the selected frame and delete its other windows
</p></dd>
</dl>

<p>Alternatively, you can use the Hyperbole menubar menu as shown here:
</p>
<div class="float"><a name="image_003aMenu_002dDisplay_002dReferents"></a>

<img src="im/menu-display-referents.png" alt="Display Referents Menu">
<div class="float-caption"><p><strong>Image B.2: </strong>Display Referents Menu</p></div></div><br>

<p>See <a href="#External-Viewers">External Viewers</a>, for instructions on associating filenames with
external, window-system specific viewers.
</p>
<hr>
<a name="External-Viewers"></a>
<div class="header">
<p>
Next: <a href="#Link-Variable-Substitution" accesskey="n" rel="next">Link Variable Substitution</a>, Previous: <a href="#Internal-Viewers" accesskey="p" rel="prev">Internal Viewers</a>, Up: <a href="#Customization" accesskey="u" rel="up">Customization</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="External-Viewers-1"></a>
<h4 class="subsection">B.3.3 External Viewers</h4>
<a name="index-hpath_003aget_002dexternal_002ddisplay_002dalist"></a>
<a name="index-hpath_003aexternal_002ddisplay_002dalist_002dmacos"></a>
<a name="index-hpath_003aexternal_002ddisplay_002dalist_002dmswindows"></a>
<a name="index-hpath_003aexternal_002ddisplay_002dalist_002dx"></a>
<a name="index-window-system"></a>
<a name="index-external-program"></a>
<a name="index-external-viewer"></a>
<a name="index-link_002c-viewer-program"></a>

<a name="index-external-display-1"></a>
<a name="index-hpath_003aexternal_002ddisplay_002dalist"></a>
<p>If you use Hyperbole under a window system,
the <code>hpath:get-external-display-alist</code> function in <samp>hpath.el</samp>
supports hyperlinks that open files using external, non-Emacs tools, e.g.
a pdf reader or a vector graphics viewer.
</p>
<p>The value returned by <code>hpath:get-external-display-alist</code> is determined
based on the window system supported by the current frame and the version
of Emacs in use.  This value is an association list whose elements are
(&lt;file-name-regular-expression&gt; . &lt;viewer-program-or-list&gt;) pairs.  Any
path whose name matches a &lt;file-name-regular-expression&gt; will be
displayed using the corresponding viewer-program or the first
viewer-program found on the system from a list of programs.  If a
&lt;viewer-program&gt; entry contains a &lsquo;<samp>%s</samp>&rsquo; string, the filename to
display is substituted at that point within the string.
Otherwise, the filename is appended to the &lt;viewer-program&gt;
entry.  Alternatively, the viewer-program may be a Lisp function that
takes a single filename argument.
</p>
<p>The association lists used by this function are stored in variables
for each available window system: <code>hpath:external-display-alist-macos</code>,
<code>hpath:external-display-alist-mswindows</code>, and
<code>hpath:external-display-alist-x</code>.  Examine and modify these
values to suit your needs.
</p>

<hr>
<a name="Link-Variable-Substitution"></a>
<div class="header">
<p>
Next: <a href="#Web-Search-Engines" accesskey="n" rel="next">Web Search Engines</a>, Previous: <a href="#External-Viewers" accesskey="p" rel="prev">External Viewers</a>, Up: <a href="#Customization" accesskey="u" rel="up">Customization</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Link-Variable-Substitution-1"></a>
<h4 class="subsection">B.3.4 Link Variable Substitution</h4>
<a name="index-hpath_003avariables"></a>
<a name="index-environment-variables-1"></a>
<a name="index-Emacs-Lisp-variables-1"></a>
<a name="index-Lisp-variables-1"></a>
<p>Another option to consider modifying is <code>hpath:variables</code>.  This
option consists of a list of Emacs Lisp variable names, each of which
may have a pathname or a list of pathnames as a value.  Whenever a
Hyperbole file or directory link button is created, its pathname is
compared against the values in <code>hpath:variables</code>.  The first
match found, if any, is selected and its associated variable name is
substituted into the link pathname, in place of its literal value.
When a link button is activated, potentially at a different site,
Hyperbole replaces each variable in the link pathname with the first
matching value from this list to recreate the literal pathname.
Environment variables and Emacs Lisp variables delimited
by \&quot;${variable-name}\&quot; are also replaced whenever link paths are
resolved.
</p>
<p>This permits sharing of links over wide areas, where the variable values
differ between link creator and link activator.  The entire process
is wholly transparent to the user; it is explained here simply to help
you in deciding whether or not to modify the value of <code>hpath:variables</code>.
</p>
<hr>
<a name="Web-Search-Engines"></a>
<div class="header">
<p>
Next: <a href="#Using-URLs-with-Find_002dFile" accesskey="n" rel="next">Using URLs with Find-File</a>, Previous: <a href="#Link-Variable-Substitution" accesskey="p" rel="prev">Link Variable Substitution</a>, Up: <a href="#Customization" accesskey="u" rel="up">Customization</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Web-Search-Engines-1"></a>
<h4 class="subsection">B.3.5 Web Search Engines</h4>

<a name="index-menu_002c-Find_002fWeb-1"></a>
<a name="index-menu_002c-Web-1"></a>
<a name="index-menu_002c-Cust_002fWeb_002dSearch"></a>
<a name="index-C_002dh-h-c-w"></a>
<a name="index-C_002dh-h-f-w"></a>
<a name="index-hyperbole_002dweb_002dsearch_002dalist"></a>
<a name="index-search-engines-menu"></a>
<a name="index-web-search-menu"></a>
<a name="index-customizing-web-search-menu"></a>
<p>The Find/Web menu offers quick access to major web search engines.  It
is typically bound to <kbd>{C-c /}</kbd> or if not, then <kbd>{C-h h f w}</kbd> is
always available.  Your standard web browser will be used to return
the search results.
</p>
<p>Advanced users can change the search engines listed in the Find/Web
menu with <kbd>{M-x customize-variable <span class="key">RET</span>
hyperbole-web-search-alist <span class="key">RET</span>}</kbd>.  Changes are automatically
reflected in the Hyperbole menus once applied.  Remember each search
engine name must begin with a unique letter and each URL must have a
%s format field indicating where to place the web search term when a
search is performed.
</p>
<p>You can change which browser is used with <kbd>{C-h h c w}</kbd>, the
Cust/Web-Search menu.  Below is the equivalent Hyperbole menubar menu.
</p>
<div class="float"><a name="image_003aWeb_002dSearch_002dBrowser_002dMenu"></a>

<img src="im/menu-web-search-browser.png" alt="Web Search Browser Menu">
<div class="float-caption"><p><strong>Image B.3: </strong>Web Search Browser Menu</p></div></div><br>

<hr>
<a name="Using-URLs-with-Find_002dFile"></a>
<div class="header">
<p>
Next: <a href="#Invisible-Text-Searches" accesskey="n" rel="next">Invisible Text Searches</a>, Previous: <a href="#Web-Search-Engines" accesskey="p" rel="prev">Web Search Engines</a>, Up: <a href="#Customization" accesskey="u" rel="up">Customization</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Using-URLs-with-Find_002dFile-1"></a>
<h4 class="subsection">B.3.6 Using URLs with Find-File</h4>

<a name="index-find_002dfile"></a>
<a name="index-find_002dfile_002c-browsing-URLs"></a>
<a name="index-browsing-URLs"></a>
<a name="index-URLs_002c-using-with-find_002dfile"></a>
<a name="index-web-pages_002c-displaying"></a>
<a name="index-remote-pathnames"></a>
<p>Hyperbole always recognizes URLs within buffers when the Action Key is
pressed on them.  But sometimes it is useful to enter a URL at a prompt
and have it displayed.  Hyperbole can recognize ftp and www URLs given to
the <code>find-file</code> command (or any other <code>find-file-*</code> commands).
But because there is added overhead with this feature, it is not enabled by
default.
</p>
<a name="index-menu-item_002c-Find_002dFile_002dURLs"></a>
<a name="index-menu-item_002c-Find_002dFile_002dAccepts_002dURLs"></a>
<p>To enable the feature, use the Hyperbole menu item Cust/Find-File-URLs
(or Find-File-Accepts-URLs on the Hyperbole/Customize pulldown
menu).  Either of these toggles acceptance of URLs.  When enabled the
string, URLs, appears in the parenthesized minor-mode section of the
modeline.
</p>
<a name="index-hpath_003afind_002dfile_002durls_002dmode"></a>
<a name="index-enabling-URLs-in-find_002dfile"></a>
<a name="index-browsing-URLs-in-find_002dfile"></a>
<p>To enable this feature each time you start the editor, add the
following to your personal initialization file after initializing
Hyperbole: <code>(hpath:find-file-urls-mode 1)</code>.
</p>
<a name="index-abbreviated-URLs"></a>
<a name="index-URLs_002c-abbreviated"></a>
<a name="index-Tramp-1"></a>
<p>Both full URLs and abbreviated ones, like <samp>www.gnu.org</samp>, are
recognized.  filename completion does not work with URLs; you
have to type or paste in the entire URL.  This feature will work only
if you have the builtin Tramp Emacs Lisp package; if you don&rsquo;t have
Tramp, an error message will be displayed when you try to enable
find-file URLs.
</p>
<a name="index-C_002dh-h-c-u"></a>
<a name="index-menu_002c-Cust_002fURL_002dDisplay"></a>
<p>The web browser used to display URLs may be set with the minibuffer
menu Cust/URL-Display <kbd>{C-h h c u}</kbd> or with this Hyperbole menubar
menu.
</p>
<div class="float"><a name="image_003aURL_002dBrowser_002dMenu"></a>

<img src="im/menu-url-browser.png" alt="URL Browser Menu">
<div class="float-caption"><p><strong>Image B.4: </strong>URL Browser Menu</p></div></div><br>

<hr>
<a name="Invisible-Text-Searches"></a>
<div class="header">
<p>
Next: <a href="#Button-Colors" accesskey="n" rel="next">Button Colors</a>, Previous: <a href="#Using-URLs-with-Find_002dFile" accesskey="p" rel="prev">Using URLs with Find-File</a>, Up: <a href="#Customization" accesskey="u" rel="up">Customization</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Invisible-Text-Searches-1"></a>
<h4 class="subsection">B.3.7 Invisible Text Searches</h4>

<a name="index-menu-item_002c-Isearch_002dInvisible"></a>
<a name="index-menu-item_002c-Toggle_002dIsearch_002dInvisible"></a>
<a name="index-isearch"></a>
<a name="index-search-1"></a>
<p>This is largely for outline modes such as the Koutliner.  By default,
character-by-character interactive search on <kbd>{C-s}</kbd> will search
through invisible/hidden text, making the text temporarily visible
until point moves past that hidden part.  When a search match is
selected, the surrounding text remains visible.
</p>
<p>You can temporarily disable searching of hidden text by typing <kbd>{M-s i}</kbd>
while in an incremental search.  This key sequence toggles that
setting and makes searches look at only visible text (or the reverse
when invoked again).  The setting lasts only through the current
interactive search.
</p>
<hr>
<a name="Button-Colors"></a>
<div class="header">
<p>
Previous: <a href="#Invisible-Text-Searches" accesskey="p" rel="prev">Invisible Text Searches</a>, Up: <a href="#Customization" accesskey="u" rel="up">Customization</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Configuring-Button-Colors"></a>
<h4 class="subsection">B.3.8 Configuring Button Colors</h4>
<a name="index-Emacs-support"></a>
<a name="index-button-highlighting-1"></a>
<a name="index-highlighting-buttons"></a>
<a name="index-button-flashing"></a>
<a name="index-flashing-buttons"></a>
<a name="index-file_002c-hui_002dep_002a_002eel"></a>
<a name="index-file_002c-hsettings_002eel"></a>
<a name="index-hproperty_003acycle_002dbut_002dcolor"></a>
<p>When Hyperbole is run under a window system, it automatically
highlights any explicit buttons in a buffer and makes them flash when
selected.  The main setting you may want change is the selection of a
color (or style) for button highlighting and button flashing.  See
the <samp>hui-*-b*.el</samp> files for lists of potential colors and the
code which supports this behavior.  A call
to <code>(hproperty:cycle-but-color)</code> in the <samp>hsettings.el</samp> file
changes the color used to highlight and flash explicit buttons.
</p>
<a name="index-hproperty_003abut_002dhighlight_002dflag"></a>
<p>Whether or not buttons are highlighted is controlled
by <code>hproperty:but-highlight-flag</code>, which defaults to &lsquo;<samp>t</samp>&rsquo;.
To disable highlighting, change this setting in <samp>hsettings.el</samp> or
use Hyperbole menu item, Cust/All-Options, and select the Hyperbole
Buttons group to edit its options.
</p>
<a name="index-hproperty_003abut_002dcreate"></a>
<p>If you read in a file with explicit buttons before you load Hyperbole,
these buttons won&rsquo;t be highlighted.  Load Hyperbole and then use
<kbd>{M-x hproperty:but-create <span class="key">RET</span>}</kbd> to highlight the buttons in
the current buffer.
</p>
<a name="index-button-emphasis"></a>
<a name="index-hproperty_003abut_002demphasize_002dflag"></a>
<p>Additionally, if <code>hproperty:but-emphasize-flag</code> is set to &lsquo;<samp>t</samp>&rsquo;,
then whenever the mouse pointer moves over an explicit button, it will
be emphasized in a different color or style.  This emphasis is in
addition to any non-mouse-sensitive button highlighting.
</p>

<hr>
<a name="Global-Key-Bindings"></a>
<div class="header">
<p>
Next: <a href="#Koutliner-Keys" accesskey="n" rel="next">Koutliner Keys</a>, Previous: <a href="#Setup" accesskey="p" rel="prev">Setup</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Global-Key-Bindings-1"></a>
<h2 class="appendix">Appendix C Global Key Bindings</h2>

<a name="index-key-binding-list"></a>
<p>This appendix covers two topics: 1. how to bind Hyperbole minibuffer
menu items to global keys and 2. summaries of all of Hyperbole&rsquo;s
global key bindings and whether each overrides any existing binding or
not.  It also describes how to temporarily disable these bindings and
how to manage whether Hyperbole overrides local, mode-specific key
bindings that hide global Hyperbole keys.
</p>
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">&bull; <a href="#Binding-Minibuffer-Menu-Items" accesskey="1">Binding Minibuffer Menu Items</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Default-Global-Bindings" accesskey="2">Default Global Bindings</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
</table>

<hr>
<a name="Binding-Minibuffer-Menu-Items"></a>
<div class="header">
<p>
Next: <a href="#Default-Global-Bindings" accesskey="n" rel="next">Default Global Bindings</a>, Previous: <a href="#Global-Key-Bindings" accesskey="p" rel="prev">Global Key Bindings</a>, Up: <a href="#Global-Key-Bindings" accesskey="u" rel="up">Global Key Bindings</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Binding-Minibuffer-Menu-Items-1"></a>
<h3 class="section">C.1 Binding Minibuffer Menu Items</h3>

<a name="index-binding-keys"></a>
<a name="index-minibuffer-menu-bindings"></a>
<a name="index-hyperbole_002dset_002dkey"></a>
<p>Use <kbd>{M-x hyperbole-set-key <span class="key">RET</span>}</kbd> to bind any global key to
any Hyperbole minibuffer item.  This command will first prompt for the
key sequence you want to use to activate the menu item.  Immediately
after it will display the Hyperbole top-level minibuffer menu.  Simply
select the item you want to bind to your key.
</p>
<hr>
<a name="Default-Global-Bindings"></a>
<div class="header">
<p>
Previous: <a href="#Binding-Minibuffer-Menu-Items" accesskey="p" rel="prev">Binding Minibuffer Menu Items</a>, Up: <a href="#Global-Key-Bindings" accesskey="u" rel="up">Global Key Bindings</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Default-Global-Bindings-1"></a>
<h3 class="section">C.2 Default Global Bindings</h3>

<p>Hyperbole&rsquo;s default global key bindings can be viewed and edited from
either the Cust/KeyBindings minibuffer menu or from the Hyperbole
menubar menu as shown here:
</p>
<div class="float"><a name="image_003aChange_002dKey_002dBindings"></a>

<img src="im/menu-key-bindings.png" alt="Change Key Bindings">
<div class="float-caption"><p><strong>Image C.1: </strong>Global Key Bindings Menu</p></div></div><br>

<p>Below are descriptions of Hyperbole&rsquo;s default keyboard key bindings:
</p>
<dl compact="compact">
<dd><a name="index-key-binding_002c-M_002dRET"></a>
<a name="index-M_002dRET-2"></a>
</dd>
<dt><kbd>{M-<span class="key">RET</span>}</kbd></dt>
<dd><p>Action Key: Invoke the Action Key in the present context.
<a name="index-C_002du-M_002dRET-1"></a>
</p></dd>
<dt><kbd>{C-u M-<span class="key">RET</span>}</kbd></dt>
<dd><p>Assist Key: Invoke the Assist Key in the present context.
</p>
<a name="index-key-binding_002c-C_002dc-_005c"></a>
<a name="index-C_002dc-_005c-1"></a>
</dd>
<dt><kbd>{C-c \}</kbd></dt>
<dd><p>HyControl: Control windows, frames and buffer display.  This binding
is made only if the key is not bound prior to loading Hyperbole.
</p>
<a name="index-C_002dc-_002f-1"></a>
<a name="index-C_002dh-h-f-w-1"></a>
<a name="index-menu_002c-Find_002fWeb-2"></a>
<a name="index-menu_002c-Web-2"></a>
<a name="index-searching-the-web-1"></a>
<a name="index-web-search-menu-1"></a>
<a name="index-C_002dc-_002f-2"></a>
</dd>
<dt><kbd>{C-c /}</kbd></dt>
<dd><p>Search the Web: Display a minibuffer menu of web search engines.  Once
an engine is selected, prompt for a search term and perform the
associated search.  This binding is made only if the key is not bound
prior to loading Hyperbole; otherwise, the Find/Web minibuffer menu
item, <kbd>{C-h h f w}</kbd>, will do the same thing.
</p>
<a name="index-C_002dc-_0040-1"></a>
<a name="index-key-binding_002c-C_002dc-_0040"></a>
<a name="index-windows-grid-1"></a>
<a name="index-grid-of-windows-1"></a>
<a name="index-C_002dc-_0040-2"></a>
</dd>
<dt><kbd>{C-c @}</kbd></dt>
<dd><p>Display a grid of windows in the selected frame, sized according to the
prefix argument.  The left digit of the argument is the number of grid rows
and the right digit is the number of grid columns.  The argument is
prompted for if not given.  This binding is made only if the key is not
bound prior to loading Hyperbole.
</p>
<p>For further details, see the <kbd>{@}</kbd> key binding description
in <a href="#HyControl">HyControl</a>.
</p>
<a name="index-key-binding_002c-M_002do"></a>
<a name="index-M_002do-1"></a>
</dd>
<dt><kbd>{M-o}</kbd></dt>
<dd><p>Drag Operation: Keyboard emulation of the start and stop of mouse
drags to invoke Smart Key actions.  This binding is made only if the
key is not bound prior to loading Hyperbole and if Emacs is run under
a window system.  If the Ace Window package is loaded, then Ace Window
commands are typically bound to <kbd>{M-o}</kbd> instead.  Then <kbd>{M-o w}</kbd>
may be used to quickly create an explicit link button in the selected window that
links to any other window chosen via the Ace Window prompt.
</p>
<a name="index-key-binding_002c-C_002dh-h"></a>
<a name="index-C_002dh-h-1"></a>
</dd>
<dt><kbd>{C-h h}</kbd></dt>
<dd><p>Hyperbole Mini Menu: Invoke the Hyperbole minibuffer menu, giving
access to many Hyperbole commands.
</p>
<a name="index-key-binding_002c-C_002dh-A"></a>
<a name="index-key-binding_002c-C_002du-C_002dh-A"></a>
<a name="index-C_002dh-A-1"></a>
</dd>
<dt><kbd>{C-h A}</kbd></dt>
<dd><p>Action Key Help: Show what the Action Key will do in the current context.
<a name="index-C_002du-C_002dh-A-1"></a>
</p></dd>
<dt><kbd>{C-u C-h A}</kbd></dt>
<dd><p>Assist Key Help: Show what the Assist Key will do in the same context.
</p>
<a name="index-key-binding_002c-C_002dc-RET"></a>
<a name="index-C_002dc-RET-1"></a>
</dd>
<dt><kbd>{C-c <span class="key">RET</span>}</kbd></dt>
<dd><p>Mark Things: Mark larger and larger synctactical units in a buffer
when invoked repeatedly, showing in the minibuffer the type of unit
marked each time.  For example, if on an opening brace at the start of
a C, Java or Javascript function, this marks the whole function.  This
binding is made only if the key is not bound prior to loading
Hyperbole.
</p>
<a name="index-key-binding_002c-C_002dc-_002e"></a>
<a name="index-C_002dc-_002e-2"></a>
</dd>
<dt><kbd>{C-c .}</kbd></dt>
<dd><p>Delimited Thing Jump: Jump between the start and end of a delimited
thing, which may be an HTML tag pair.  This binding is made only if
the key is not bound prior to loading Hyperbole.  See <a href="#Smart-Key-Thing-Selection">Smart Key Thing Selection</a>, for more information.
</p></dd>
</dl>

<a name="index-hkey_002dinit"></a>
<a name="index-disable-global-key-bindings"></a>
<p>The variable, <code>hkey-init</code>, controls whether or not any Hyperbole
global key bindings are made.  It is set to &lsquo;<samp>t</samp>&rsquo; (true) by default in
<samp>hyperbole.el</samp>.  This setting means all Hyperbole key bindings will
be initialized when Hyperbole is loaded.  If you want to disable these
bindings permanently, simply add <code>(setq hkey-init nil)</code> to
your <samp>~/.emacs</samp> file prior to the point at which you load Hyperbole
and restart Emacs.  Then you will have to choose the Hyperbole commands
that you want to use and bind those to keys.
</p>
<a name="index-file_002c-_002eemacs-4"></a>
<a name="index-hyperbole_002dtoggle_002dbindings-1"></a>
<a name="index-change-key-bindings-1"></a>
<a name="index-toggle-key-bindings-1"></a>
<a name="index-key-bindings_002c-toggle-1"></a>
<a name="index-disable-Hyperbole-1"></a>
<a name="index-C_002dc-h-1"></a>
<p>If you ever have a need to temporarily disable the Hyperbole keyboard and
mouse bindings, use the <code>hyperbole-toggle-bindings</code> command.  It
switches between the Hyperbole key bindings and those set prior to loading
Hyperbole and then back again if invoked once more.  There is no default
key binding for this command; use <kbd>{M-x hyperbole-toggle-bindings
<span class="key">RET</span>}</kbd>.  Alternatively, you may select a key and bind it as part of any
setting of <code>hyperbole-init-hook</code> within your personal <samp>~/.emacs</samp>
file.  For example, <code>(add-hook 'hyperbole-init-hook (lambda ()
(global-set-key &quot;\C-ch&quot; 'hyperbole-toggle-bindings)))</code>.
</p>
<a name="index-file_002c-_002eemacs-5"></a>
<a name="index-hmouse_002dtoggle_002dbindings"></a>
<a name="index-mouse-key-toggle"></a>
<a name="index-Smart-Mouse-Key-toggle"></a>
<a name="index-C_002dc-t"></a>
<p>If you want to restore only the mouse bindings that existed before
Hyperbole was loaded, use the <code>hmouse-toggle-bindings</code> command.
It switches between the Hyperbole mouse key bindings and those set
prior to loading Hyperbole and then back again if invoked once more.
There is no default key binding for this command; use <kbd>{M-x
hmouse-toggle-bindings <span class="key">RET</span>}</kbd>.  Alternatively, you may select a
key and bind it as part of any setting of <code>hyperbole-init-hook</code>
within your personal <samp>~/.emacs</samp> file.  For example, <code>(add-hook
'hyperbole-init-hook (lambda () (global-set-key &quot;\C-ct&quot;
'hmouse-toggle-bindings)))</code>.
</p>
<a name="index-hkey_002dinit_002doverride_002dlocal_002dkeys"></a>
<a name="index-overriding-local-keys"></a>
<a name="index-disable-local-key-override"></a>
<p>Major mode-specific keys take precedence over global key bindings.  In
some cases, a major mode will unknowingly override some of the global
Hyperbole keys, preventing you from using them in that mode.  By
default, Hyperbole automatically prevents this by checking each time a
major mode is invoked and unbinding any mode-specific keys that
interfere with global Hyperbole keys.  If you prefer that this not
happen permanently, use <kbd>{M-x customize-variable <span class="key">RET</span>
hkey-init-override-local-keys <span class="key">RET</span>}</kbd>.  Press the Toggle button to
change the value to <code>nil</code>.  Then press the &ldquo;Apply and Save&rdquo;
button.
</p>
<hr>
<a name="Koutliner-Keys"></a>
<div class="header">
<p>
Next: <a href="#Smart-Key-Reference" accesskey="n" rel="next">Smart Key Reference</a>, Previous: <a href="#Global-Key-Bindings" accesskey="p" rel="prev">Global Key Bindings</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Koutliner-Keys-1"></a>
<h2 class="appendix">Appendix D Koutliner Keys</h2>

<a name="index-outliner-keys"></a>
<p>This appendix summarizes the specialized key bindings available when
editing a koutline with Hyperbole.  Each key is shown together with its
command binding and the documentation for that command.  Normal emacs
editing keys are modified to account for the structure within outlines.
An outliner command which overloads an emacs command named <em>cmd</em>
is named <em>kotl-mode:cmd</em>.
</p>
<dl compact="compact">
<dd>
<a name="index-kfile_003awrite"></a>
</dd>
<dt><code>kfile:write  <kbd>{C-x C-w}</kbd></code></dt>
<dd><p>Write the current outline to FILE.
</p>
<a name="index-klink_003acreate-1"></a>
</dd>
<dt><code>klink:create  <kbd>{C-c l}</kbd></code></dt>
<dd><p>Insert at point an implicit link to REFERENCE.
REFERENCE should be a cell-ref or a string containing &quot;filename, cell-ref&quot;.
See the documentation for <code>(kcell:ref-to-id)</code> for valid cell-ref
formats.
</p>
<a name="index-kotl_002dmode_003aadd_002dcell"></a>
</dd>
<dt><code>kotl-mode:add-cell  <kbd>{C-j}</kbd></code></dt>
<dd><p>Add a cell following current cell at optional RELATIVE-LEVEL with CONTENTS string.
Optional prefix arg RELATIVE-LEVEL means add as sibling if nil or &gt;= 0, as child
if equal to universal argument, <kbd>{C-u}</kbd>, and as sibling of current cell&rsquo;s
parent, otherwise.  If added as sibling of current level, RELATIVE-LEVEL is
used as a repeat count for the number of cells to add.
</p>
<p>Return last newly added cell.
</p>
<a name="index-kotl_002dmode_003aadd_002dchild"></a>
</dd>
<dt><code>kotl-mode:add-child  <kbd>{C-c a}</kbd></code></dt>
<dd><p>Add a new cell to current kview as first child of current cell.
</p>
<a name="index-kotl_002dmode_003aadd_002dparent"></a>
</dd>
<dt><code>kotl-mode:add-parent  <kbd>{C-c p}</kbd></code></dt>
<dd><p>Add a new cell to current kview as sibling of current cell&rsquo;s parent.
</p>
<a name="index-kotl_002dmode_003aappend_002dcell"></a>
</dd>
<dt><code>kotl-mode:append-cell  <kbd>{C-c +}</kbd></code></dt>
<dd><p>Append the CONTENTS-CELL to APPEND-TO-CELL.  If neither cell has a
no-fill property and <code>kotl-mode:refill-flag</code> is enabled, then
APPEND-TO-CELL is refilled.
</p>
<a name="index-kotl_002dmode_003aback_002dto_002dindentation"></a>
</dd>
<dt><code>kotl-mode:back-to-indentation  <kbd>{M-m}</kbd></code></dt>
<dd><p>Move point to the first non-read-only non-whitespace character on this line.
</p>
<a name="index-kotl_002dmode_003abackward_002dcell"></a>
</dd>
<dt><code>kotl-mode:backward-cell  <kbd>{C-c C-b}</kbd></code></dt>
<dd><p>Move to prefix ARGth prior cell (same level) within current view.
Return number of cells left to move.
</p>
<a name="index-kotl_002dmode_003abackward_002dchar"></a>
</dd>
<dt><code>kotl-mode:backward-char  <kbd>{C-b}</kbd></code></dt>
<dd><p>Move point backward ARG (or 1) characters and return point.
</p>
<a name="index-kotl_002dmode_003abackward_002dkill_002dword"></a>
</dd>
<dt><code>kotl-mode:backward-kill-word  <kbd>{M-DEL}</kbd></code></dt>
<dd><p>Kill up to prefix ARG (or 1) words preceding point within a single cell.
</p>
<a name="index-kotl_002dmode_003abackward_002dsentence"></a>
</dd>
<dt><code>kotl-mode:backward-sentence  <kbd>{M-a}</kbd></code></dt>
<dd><p>Move point backward ARG (or 1) sentences and return point.
</p>
<a name="index-kotl_002dmode_003abackward_002dword"></a>
</dd>
<dt><code>kotl-mode:backward-word  <kbd>{M-b}</kbd></code></dt>
<dd><p>Move point backward ARG (or 1) words and return point.
</p>
<a name="index-kotl_002dmode_003abeginning_002dof_002dbuffer"></a>
</dd>
<dt><code>kotl-mode:beginning-of-buffer  <kbd>{M-&lt;}</kbd></code></dt>
<dd><p>Move point to beginning of buffer and return point.
</p>
<a name="index-kotl_002dmode_003abeginning_002dof_002dcell"></a>
</dd>
<dt><code>kotl-mode:beginning-of-cell  <kbd>{C-c ,}</kbd></code></dt>
<dd><p>Move point to beginning of current or ARGth - 1 prior cell and return point.
</p>
<a name="index-kotl_002dmode_003abeginning_002dof_002dline"></a>
</dd>
<dt><code>kotl-mode:beginning-of-line  <kbd>{C-a}</kbd></code></dt>
<dd><p>Move point to beginning of current or ARGth - 1 line and return point.
</p>
<a name="index-kotl_002dmode_003abeginning_002dof_002dtree"></a>
</dd>
<dt><code>kotl-mode:beginning-of-tree  <kbd>{C-c ^}</kbd></code></dt>
<dd><p>Move point to the level 1 root of the current cell&rsquo;s tree.
Leave point at the start of the cell.
</p>
<a name="index-kotl_002dmode_003acell_002dhelp"></a>
</dd>
<dt><code>kotl-mode:cell-help  <kbd>{C-c h}</kbd></code></dt>
<dd><p>Display a temporary buffer of CELL-REF&rsquo;s attributes.
CELL-REF defaults to current cell.  Optional prefix arg CELLS-FLAG
selects the cells to print:
</p>
<div class="example">
<pre class="example">If = 1, print CELL-REF's cell only;
If &gt; 1, print the visible tree rooted at CELL-REF;
If &lt; 1, print all visible cells in current view
  (In this last case, CELL-REF is not used).
</pre></div>

<a name="index-kotl_002dmode_003acell_002dattributes"></a>
<p>See also the documentation for <code>kotl-mode:cell-attributes</code>.
</p>
<a name="index-kotl_002dmode_003acenter_002dline"></a>
<a name="index-fill_002dcolumn"></a>
</dd>
<dt><code>kotl-mode:center-line  <kbd>{M-s}</kbd></code></dt>
<dd><p>Center the line point is on, within the width specified by <code>fill-column</code>.
This means adjusting the indentation so that it equals the distance between
the end of the text and <code>fill-column</code>.
</p>
<a name="index-kotl_002dmode_003acenter_002dparagraph"></a>
</dd>
<dt><code>kotl-mode:center-paragraph  <kbd>{M-S}</kbd></code></dt>
<dd><p>Center each nonblank line in the paragraph at or after point.
See <code>center-line</code> for more information.
</p>
<a name="index-kotl_002dmode_003acopy_002dafter"></a>
</dd>
<dt><code>kotl-mode:copy-after  <kbd>{C-c c}</kbd></code></dt>
<dd><p>Copy tree rooted at FROM-CELL-REF to follow tree rooted at TO-CELL-REF.
If prefix arg CHILD-P is non-nil, make FROM-CELL-REF the first child of
TO-CELL-REF, otherwise make it the sibling following TO-CELL-REF.
</p>
<p>Leave point at the start of the root cell of the new tree.
</p>
<a name="index-kotl_002dmode_003acopy_002dbefore"></a>
</dd>
<dt><code>kotl-mode:copy-before  <kbd>{C-c C-c}</kbd></code></dt>
<dd><p>Copy tree rooted at FROM-CELL-REF to precede tree rooted at TO-CELL-REF.
If prefix arg PARENT-P is non-nil, make FROM-CELL-REF the first child of
TO-CELL-REF&rsquo;s parent, otherwise make it the preceding sibling of TO-CELL-REF.
</p>
<p>Leave point at the start of the root cell of the new tree.
</p>
<a name="index-kotl_002dmode_003acopy_002dto_002dbuffer"></a>
</dd>
<dt><code>kotl-mode:copy-to-buffer  <kbd>{C-c M-c}</kbd></code></dt>
<dd><p>Copy outline tree rooted at CELL-REF to a non-koutline BUFFER.
Use 0 to copy the whole outline buffer.
</p>
<a name="index-kotl_002dmode_003acopy_002dto_002dregister"></a>
</dd>
<dt><code>kotl-mode:copy-to-register  <kbd>{C-x x}</kbd></code></dt>
<dd><p>Copy into REGISTER the region START to END.
With optional prefix arg DELETE-FLAG, delete region.
</p>
<a name="index-kotl_002dmode_003adelete_002dbackward_002dchar"></a>
</dd>
<dt><code>kotl-mode:delete-backward-char  {<span class="key">DEL</span>}</code></dt>
<dd><p>Delete up to the preceding prefix ARG characters.
Return number of characters deleted.
Optional KILL-FLAG non-nil means save in kill ring instead of deleting.
Does not delete across cell boundaries.
</p>
<a name="index-kotl_002dmode_003adelete_002dblank_002dlines"></a>
</dd>
<dt><code>kotl-mode:delete-blank-lines  <kbd>{C-x C-o}</kbd></code></dt>
<dd><p>On blank line within a cell, delete all surrounding blank lines, leaving just one.
On isolated blank line, delete that one.
On nonblank line, delete all blank lines that follow it.
</p>
<p>If nothing but whitespace follows point until the end of a cell, delete all
whitespace at the end of the cell.
</p>
<a name="index-kotl_002dmode_003adelete_002dchar"></a>
</dd>
<dt><code>kotl-mode:delete-char  <kbd>{C-d}</kbd></code></dt>
<dd><p>Delete up to prefix ARG characters following point.
Return number of characters deleted.
Optional KILL-FLAG non-nil means save in kill ring instead of deleting.
Does not delete across cell boundaries.
</p>
<a name="index-kotl_002dmode_003adelete_002dindentation"></a>
</dd>
<dt><code>kotl-mode:delete-indentation  <kbd>{M-^}</kbd></code></dt>
<dd><p>Join this line to previous and fix up whitespace at join.
If there is a fill prefix, delete it from the beginning of this line.
With argument, join this line to the following line.
</p>
<a name="index-kotl_002dmode_003ademote_002dtree"></a>
</dd>
<dt><code>kotl-mode:demote-tree  {<span class="key">TAB</span>}</code></dt>
<dd><p>Move current tree a maximum of prefix ARG levels lower in current view.
Each cell is refilled iff its <em>no-fill</em> attribute is nil and
<code>kotl-mode:refill-flag</code> is non-nil.  With prefix ARG = 0, cells are
demoted up to one level and <code>kotl-mode:refill-flag</code> is treated as
true.
</p>
<a name="index-kotl_002dmode_003adown_002dlevel"></a>
</dd>
<dt><code>kotl-mode:down-level  <kbd>{C-c C-d}</kbd></code></dt>
<dd><p>Move down prefix ARG levels lower within current tree.
</p>
<a name="index-kotl_002dmode_003aend_002dof_002dbuffer"></a>
</dd>
<dt><code>kotl-mode:end-of-buffer  <kbd>{M-&gt;}</kbd></code></dt>
<dd><p>Move point to the end of buffer and return point.
</p>
<a name="index-kotl_002dmode_003aend_002dof_002dcell"></a>
</dd>
<dt><code>kotl-mode:end-of-cell  <kbd>{C-c .}</kbd></code></dt>
<dd><p>Move point to end of current or ARGth - 1 succeeding cell and return point.
</p>
<a name="index-kotl_002dmode_003aend_002dof_002dline"></a>
</dd>
<dt><code>kotl-mode:end-of-line  <kbd>{C-e}</kbd></code></dt>
<dd><p>Move point to end of current or ARGth - 1 line and return point.
</p>
<a name="index-kotl_002dmode_003aend_002dof_002dtree"></a>
</dd>
<dt><code>kotl-mode:end-of-tree  <kbd>{C-c $}</kbd></code></dt>
<dd><p>Move point to the last cell in tree rooted at the current cell.
Leave point at the start of the cell.
</p>
<a name="index-kotl_002dmode_003aexample"></a>
</dd>
<dt><code>kotl-mode:example</code></dt>
<dd><p>Display the Koutliner example file for demonstration use by a user.
</p>
<a name="index-kotl_002dmode_003aexchange_002dcells"></a>
</dd>
<dt><code>kotl-mode:exchange-cells  <kbd>{C-c e}</kbd></code></dt>
<dd><p>Exchange CELL-REF-1 with CELL-REF-2 in current view.  Don&rsquo;t move point.
</p>
<a name="index-kotl_002dmode_003afill_002dcell"></a>
</dd>
<dt><code>kotl-mode:fill-cell  <kbd>{C-c M-j}</kbd></code></dt>
<dd><p>Fill current cell if it lacks the <em>no-fill</em> attribute.
With optional JUSTIFY, justify cell as well.  IGNORE-COLLAPSED-P is used
when caller has already expanded cell, indicating it is not collapsed.
</p>
<a name="index-kotl_002dmode_003afill_002dparagraph"></a>
</dd>
<dt><code>kotl-mode:fill-paragraph  <kbd>{C-x f}</kbd></code></dt>
<dd><p>Fill current paragraph within cell.  With optional JUSTIFY, justify
paragraph as well.  Ignore any non-nil <em>no-fill</em> attribute attached
to the cell.
</p>
<a name="index-kotl_002dmode_003afill_002dtree"></a>
</dd>
<dt><code>kotl-mode:fill-tree  <kbd>{C-M-j}</kbd></code></dt>
<dd><p>Refill each cell within the tree whose root is at point.
</p>
<a name="index-kotl_002dmode_003afirst_002dsibling"></a>
</dd>
<dt><code>kotl-mode:first-sibling  <kbd>{C-c &lt;}</kbd></code></dt>
<dd><p>Move point to the first sibling of the present cell.
Leave point at the start of the cell or at its present position if it is
already within the first sibling cell.
</p>
<a name="index-kotl_002dmode_003afkey_002dbackward_002dchar"></a>
</dd>
<dt><code>kotl-mode:fkey-backward-char  <kbd>{C-b}</kbd> or <kbd>{left}</kbd></code></dt>
<dd><p>Move point backward ARG (or 1) characters and return point.
</p>
<a name="index-kotl_002dmode_003afkey_002dforward_002dchar"></a>
</dd>
<dt><code>kotl-mode:fkey-forward-char  <kbd>{C-f}</kbd> or <kbd>{right}</kbd></code></dt>
<dd><p>Move point forward ARG (or 1) characters and return point.
</p>
<a name="index-kotl_002dmode_003afkey_002dnext_002dline"></a>
</dd>
<dt><code>kotl-mode:fkey-next-line  <kbd>{C-n}</kbd> or <kbd>{down}</kbd></code></dt>
<dd><p>Move point to ARGth next line and return point.
</p>
<a name="index-kotl_002dmode_003afkey_002dprevious_002dline"></a>
</dd>
<dt><code>kotl-mode:fkey-previous-line  <kbd>{C-p}</kbd> or <kbd>{up}</kbd></code></dt>
<dd><p>Move point to ARGth previous line and return point.
</p>
<a name="index-kotl_002dmode_003aforward_002dcell"></a>
</dd>
<dt><code>kotl-mode:forward-cell  <kbd>{C-c C-f}</kbd></code></dt>
<dd><p>Move to the prefix ARG following cell (same level) within current view.
Return number of cells left to move.
</p>
<a name="index-kotl_002dmode_003aforward_002dchar"></a>
</dd>
<dt><code>kotl-mode:forward-char  <kbd>{C-f}</kbd></code></dt>
<dd><p>Move point forward ARG (or 1) characters and return point.
</p>
<a name="index-kotl_002dmode_003aforward_002dpara"></a>
</dd>
<dt><code>kotl-mode:forward-para  <kbd>{M-n}</kbd></code></dt>
<dd><p>Move to prefix ARGth next cell (any level) within current view.
</p>
<a name="index-kotl_002dmode_003aforward_002dparagraph"></a>
</dd>
<dt><code>kotl-mode:forward-paragraph  <kbd>{M-]}</kbd></code></dt>
<dd><p>Move to prefix ARG next cell (any level) within current view.
</p>
<a name="index-kotl_002dmode_003aforward_002dsentence"></a>
</dd>
<dt><code>kotl-mode:forward-sentence  <kbd>{M-e}</kbd></code></dt>
<dd><p>Move point forward ARG (or 1) sentences and return point.
</p>
<a name="index-kotl_002dmode_003aforward_002dword"></a>
</dd>
<dt><code>kotl-mode:forward-word  <kbd>{M-f}</kbd></code></dt>
<dd><p>Move point forward ARG (or 1) words and return point.
</p>
<a name="index-kotl_002dmode_003agoto_002dcell"></a>
</dd>
<dt><code>kotl-mode:goto-cell  <kbd>{C-c g}</kbd></code></dt>
<dd><p>Move point to start of cell given by CELL-REF.  (See the documentation
for <code>(kcell:ref-to-id)</code>, for valid formats.)  Return point iff
CELL-REF is found within current view.  With a prefix argument, CELL-REF
is assigned the argument value for use as an idstamp.
</p>
<p>Optional second arg, ERROR-P, non-nil means signal an error if CELL-REF is
not found within current view.  Will signal same error if called
interactively when CELL-REF is not found.
</p>
<a name="index-kotl_002dmode_003ahide_002dsublevels-1"></a>
</dd>
<dt><code>kotl-mode:hide-sublevels  <kbd>{C-X $}</kbd></code></dt>
<dd><p>Hide all cells in outline at levels deeper than LEVELS-TO-KEEP (a
number). Show any hidden cells within LEVELS-TO-KEEP.  1 is the first
level.
</p>
<a name="index-kotl_002dmode_003ahide_002dsubtree"></a>
</dd>
<dt><code>kotl-mode:hide-subtree  <kbd>{C-M-h}</kbd></code></dt>
<dd><p>Hide subtree, ignoring root, at optional CELL-REF (defaults to cell at
point).
</p>
<a name="index-kotl_002dmode_003ahide_002dtree-1"></a>
</dd>
<dt><code>kotl-mode:hide-tree  <kbd>{C-c BS}</kbd></code></dt>
<dd><p>Collapse tree rooted at optional CELL-REF (defaults to cell at point).
</p>
<a name="index-kotl_002dmode_003aindent_002dline"></a>
</dd>
<dt><code>kotl-mode:indent-line  {<span class="key">TAB</span>}</code></dt>
<dd><p>Indent line relative to the previous one.
With optional prefix ARG greater than 1, tab forward ARG times.
See the documentation string of &lsquo;kotl-mode:indent-tabs-mode&rsquo; for details
on when tabs are used for indenting.
</p>
<a name="index-kotl_002dmode_003aindent_002dregion"></a>
</dd>
<dt><code>kotl-mode:indent-region  <kbd>{C-M-\}</kbd></code></dt>
<dd><p>Indent each nonblank line in the region from START to END.
If there is a fill prefix, make each line start with the fill prefix.
With argument COLUMN, indent each line to that column.
Called from a program, takes three args: START, END and COLUMN.
</p>
<a name="index-kimport_003ainsert_002dfile"></a>
</dd>
<dt><code>kimport:insert-file  <kbd>{C-x i}</kbd></code></dt>
<dd><p>Insert each paragraph in IMPORT-FROM as a separate cell in the current view.
Insert as sibling cells following the current cell.  IMPORT-FROM may be a
buffer name or filename (filename completion is provided).
</p>
<a name="index-kimport_003ainsert_002dregister"></a>
</dd>
<dt><code>kimport:insert-register  <kbd>{C-x r i}</kbd></code></dt>
<dd><p>Insert contents of REGISTER at point in current cell.
REGISTER is a character naming the register to insert.
Normally puts point before and mark after the inserted text.
If optional second arg is non-nil, puts mark before and point after.
Interactively, second arg is non-nil if prefix arg is supplied.
</p>
<a name="index-kotl_002dmode_003ajust_002done_002dspace"></a>
</dd>
<dt><code>kotl-mode:just-one-space  <kbd>{M-\}</kbd></code></dt>
<dd><p>Delete all spaces and tabs around point and leave one space.
</p>
<a name="index-kotl_002dmode_003akill_002dcontents"></a>
</dd>
<dt><code>kotl-mode:kill-contents  <kbd>{C-c k}</kbd></code></dt>
<dd><p>Kill contents of cell from point to cell end.
With prefix ARG, kill entire cell contents.
</p>
<a name="index-kotl_002dmode_003akill_002dline"></a>
</dd>
<dt><code>kotl-mode:kill-line  <kbd>{C-k}</kbd></code></dt>
<dd><p>Kill ARG lines from point.
</p>
<a name="index-kotl_002dmode_003akill_002dregion"></a>
</dd>
<dt><code>kotl-mode:kill-region  <kbd>{C-w}</kbd></code></dt>
<dd><p>Kill region between START and END within a single kcell.
With optional COPY-P equal to t, copy region to kill ring but don&rsquo;t
kill it.  With COPY-P any other non-nil value, return region as a
string without affecting the kill ring.
</p>
<p>If the buffer is read-only and COPY-P is nil, the region will not be
deleted but it will be copied to the kill ring and then an error will be
signaled.
</p>
<a name="index-kotl_002dmode_003akill_002dring_002dsave"></a>
</dd>
<dt><code>kotl-mode:kill-ring-save  <kbd>{M-w}</kbd></code></dt>
<dd><p>Copy region between START and END within a single kcell to kill ring.
</p>
<a name="index-kotl_002dmode_003akill_002dsentence"></a>
</dd>
<dt><code>kotl-mode:kill-sentence  <kbd>{M-k}</kbd></code></dt>
<dd><p>Kill up to prefix ARG (or 1) sentences following point within a single cell.
</p>
<a name="index-kotl_002dmode_003akill_002dtree-1"></a>
</dd>
<dt><code>kotl-mode:kill-tree  <kbd>{C-c C-k}</kbd></code></dt>
<dd><p>Kill ARG following trees starting with tree rooted at point.
If ARG is a non-positive number, nothing is done.
</p>
<a name="index-kotl_002dmode_003akill_002dword"></a>
</dd>
<dt><code>kotl-mode:kill-word  <kbd>{M-d}</kbd></code></dt>
<dd><p>Kill up to prefix ARG words following point within a single cell.
</p>
<a name="index-kotl_002dmode_003alast_002dsibling"></a>
</dd>
<dt><code>kotl-mode:last-sibling  <kbd>{C-c &gt;}</kbd></code></dt>
<dd><p>Move point to the last sibling of the present cell.
Leave point at the start of the cell or at its present position if it is
already within the last sibling cell.
</p>
<a name="index-kotl_002dmode_003amail_002dtree"></a>
</dd>
<dt><code>kotl-mode:mail-tree  <kbd>{C-c @}</kbd></code></dt>
<dd><p>Mail outline tree rooted at CELL-REF.  Use &quot;0&quot; for whole outline buffer.
</p>
<a name="index-kotl_002dmode_003amove_002dafter"></a>
</dd>
<dt><code>kotl-mode:move-after  <kbd>{C-c m}</kbd></code></dt>
<dd><p>Move tree rooted at FROM-CELL-REF to follow tree rooted at TO-CELL-REF.
If prefix arg CHILD-P is non-nil, make FROM-CELL-REF the first child of
TO-CELL-REF, otherwise make it the sibling following TO-CELL-REF.
With optional COPY-P, copy tree rather than moving it.
</p>
<p>Leave point at original location but return the tree&rsquo;s new start point.
</p>
<a name="index-kotl_002dmode_003amove_002dbefore"></a>
</dd>
<dt><code>kotl-mode:move-before  <kbd>{C-c <span class="key">RET</span>}</kbd></code></dt>
<dd><p>Move tree rooted at FROM-CELL-REF to precede tree rooted at TO-CELL-REF.
If prefix arg PARENT-P is non-nil, make FROM-CELL-REF the first child of
TO-CELL-REF&rsquo;s parent, otherwise make it the preceding sibling of
TO-CELL-REF.  With optional COPY-P, copy tree rather than moving it.
</p>
<p>Leave point at original location but return the tree&rsquo;s new start point.
</p>
<a name="index-kotl_002dmode_003anewline"></a>
</dd>
<dt><code>kotl-mode:newline  {<span class="key">RET</span>}</code></dt>
<dd><p>Insert a newline.  With ARG, insert ARG newlines.
In Auto Fill mode, if no numeric arg, break the preceding line if it is
too long.
</p>
<a name="index-kotl_002dmode_003anext_002dcell"></a>
</dd>
<dt><code>kotl-mode:next-cell  <kbd>{C-c C-n}</kbd></code></dt>
<dd><p>Move to prefix ARG next cell (any level) within current view.
</p>
<a name="index-kotl_002dmode_003anext_002dline"></a>
</dd>
<dt><code>kotl-mode:next-line  <kbd>{C-n}</kbd></code></dt>
<dd><p>Move point to ARGth next line and return point.
</p>
<a name="index-kotl_002dmode_003aopen_002dline"></a>
</dd>
<dt><code>kotl-mode:open-line  <kbd>{C-o}</kbd></code></dt>
<dd><p>Insert a newline and leave point before it.
With arg N, insert N newlines.
</p>
<a name="index-kotl_002dmode_003aoverview-1"></a>
</dd>
<dt><code>kotl-mode:overview  <kbd>{C-c C-o}</kbd></code></dt>
<dd><p>Show only the first line of each cell in the current outline.  With a
prefix arg, also toggle the display of blank lines between cells.
</p>
<a name="index-kotl_002dmode_003aprevious_002dcell"></a>
</dd>
<dt><code>kotl-mode:previous-cell  <kbd>{C-c C-p}</kbd></code></dt>
<dd><p>Move to prefix ARG previous cell (any level) within current view.
</p>
<a name="index-kotl_002dmode_003aprevious_002dline"></a>
</dd>
<dt><code>kotl-mode:previous-line  <kbd>{C-p}</kbd></code></dt>
<dd><p>Move point to ARGth previous line and return point.
</p>
<a name="index-kotl_002dmode_003apromote_002dtree"></a>
</dd>
<dt><code>kotl-mode:promote-tree  <kbd>{M-<span class="key">TAB</span>}</kbd> or <kbd>{<span class="key">SHIFT</span>-<span class="key">TAB</span>}</kbd></code></dt>
<dd><p>Move current tree a maximum of prefix ARG levels higher in current view.
Each cell is refilled iff its <em>no-fill</em> attribute is nil and
<code>kotl-mode:refill-flag</code> is non-nil.  With prefix ARG = 0, cells are
promoted up to one level and <code>kotl-mode:refill-flag</code> is treated as true.
</p>
<a name="index-kotl_002dmode_003ascroll_002ddown"></a>
</dd>
<dt><code>kotl-mode:scroll-down  <kbd>{M-v}</kbd></code></dt>
<dd><p>Scroll text of current window downward ARG lines; or a windowful if no ARG.
</p>
<a name="index-kotl_002dmode_003ascroll_002dup"></a>
</dd>
<dt><code>kotl-mode:scroll-up  <kbd>{C-v}</kbd></code></dt>
<dd><p>Scroll text of current window upward ARG lines; or a windowful if no ARG.
</p>
<a name="index-kotl_002dmode_003aset_002dcell_002dattribute"></a>
</dd>
<dt><code>kotl-mode:set-cell-attribute  <kbd>{C-c C-i}</kbd></code></dt>
<dd><p>Include ATTRIBUTE VALUE with the current cell or the cell at optional POS.
Replace any existing value that ATTRIBUTE has.  When called
interactively, display the setting in the minibuffer as confirmation.
</p>
<a name="index-kotl_002dmode_003aset_002dfill_002dprefix"></a>
</dd>
<dt><code>kotl-mode:set-fill-prefix  <kbd>{C-x l}</kbd></code></dt>
<dd><p>Set fill prefix to line up to point.
With prefix arg TURN-OFF or at begin of line, turn fill prefix off.
</p>
<a name="index-kotl_002dmode_003ashow_002dall-1"></a>
</dd>
<dt><code>kotl-mode:show-all  <kbd>{C-c C-a}</kbd></code></dt>
<dd><p>Show (expand) all cells in current view.  With a prefix arg, also
toggle the display of blank lines between cells.
</p>
<a name="index-kotl_002dmode_003ashow_002dsubtree"></a>
</dd>
<dt><code>kotl-mode:show-subtree</code></dt>
<dd><p>Show subtree, ignoring root, at optional CELL-REF (defaults to cell at
point).
</p>
<a name="index-kotl_002dmode_003ashow_002dtree-1"></a>
</dd>
<dt><code>kotl-mode:show-tree  <kbd>{C-c C-s}</kbd></code></dt>
<dd><p>Display fully expanded tree rooted at CELL-REF.
</p>
<a name="index-kotl_002dmode_003asplit_002dcell"></a>
</dd>
<dt><code>kotl-mode:split-cell  <kbd>{C-c s}</kbd></code></dt>
<dd><p>Split cell into two cells and move to new cell.
Cell contents after point become part of newly created cell.
Default is to create new cell as sibling of current cell.
With optional universal ARG, <kbd>{C-u}</kbd>, new cell is added as child of
current cell.
</p>
<a name="index-kotl_002dmode_003atop_002dcells-1"></a>
</dd>
<dt><code>kotl-mode:top-cells  <kbd>{C-c C-t}</kbd></code></dt>
<dd><p>Collapse all level 1 cells in view and hide any deeper sublevels.
With a prefix arg, also toggle the display of blank lines between
cells.
</p>
<a name="index-kotl_002dmode_003atranspose_002dcells"></a>
</dd>
<dt><code>kotl-mode:transpose-cells  <kbd>{C-c t}</kbd></code></dt>
<dd><p>Exchange current and previous visible cells, leaving point after both.
If no previous cell, exchange current with next cell.
With prefix ARG, take current cell and move it past ARG cells.
With prefix ARG = 0, interchange the cell that contains point with the cell
that contains mark.
</p>
<a name="index-kotl_002dmode_003atranspose_002dchars"></a>
</dd>
<dt><code>kotl-mode:transpose-chars  <kbd>{C-t}</kbd></code></dt>
<dd><p>Interchange characters around point, moving forward one character.
With prefix ARG, take character before point and drag it forward past ARG
other characters (backward if ARG negative).
If no prefix ARG and at end of line, the previous two characters are
exchanged.
</p>
<a name="index-kotl_002dmode_003atranspose_002dlines"></a>
</dd>
<dt><code>kotl-mode:transpose-lines  <kbd>{C-x C-t}</kbd></code></dt>
<dd><p>Exchange current line and previous line, leaving point after both.
If no previous line, exchange current with next line.
With prefix ARG, take previous line and move it past ARG lines.
With prefix ARG = 0, interchange the line that contains point with the line
that contains mark.
</p>
<a name="index-kotl_002dmode_003atranspose_002dwords"></a>
</dd>
<dt><code>kotl-mode:transpose-words  <kbd>{M-t}</kbd></code></dt>
<dd><p>Interchange words around point, leaving point after both words.
With prefix ARG, take word before or around point and drag it forward past
ARG other words (backward if ARG negative).  If ARG is zero, the words around
or after point and around or after mark are interchanged.
</p>
<a name="index-kotl_002dmode_003aup_002dlevel"></a>
</dd>
<dt><code>kotl-mode:up-level  <kbd>{C-c C-u}</kbd></code></dt>
<dd><p>Move up prefix ARG levels higher in current outline view.
</p>
<a name="index-kotl_002dmode_003ayank"></a>
</dd>
<dt><code>kotl-mode:yank  <kbd>{C-y}</kbd></code></dt>
<dd><p>Reinsert the last stretch of killed text.
More precisely, reinsert the stretch of killed text most recently
killed OR yanked.  Put point at end, and set mark at beginning.
With just C-u as argument, same but put point at beginning (and mark at end).
With argument N, reinsert the Nth most recently killed stretch of killed
text.
See also the command, <code>(kotl-mode:yank-pop)</code>.
</p>
<a name="index-kotl_002dmode_003ayank_002dpop"></a>
</dd>
<dt><code>kotl-mode:yank-pop  <kbd>{M-y}</kbd></code></dt>
<dd><p>Replace just-yanked stretch of killed text with a different stretch.
This command is allowed only immediately after a <code>(yank)</code> or a
<code>(yank-pop)</code>.  At such a time, the region contains a stretch of
reinserted previously-killed text.  <code>(yank-pop)</code> deletes that text
and inserts in its place a different stretch of killed text.
</p>
<p>With no argument, the previous kill is inserted.
With argument N, insert the Nth previous kill.
If N is negative, this is a more recent kill.
</p>
<p>The sequence of kills wraps around, so that after the oldest one
comes the newest one.
</p>
<a name="index-kotl_002dmode_003azap_002dto_002dchar"></a>
</dd>
<dt><code>kotl-mode:zap-to-char  <kbd>{M-z}</kbd></code></dt>
<dd><p>Kill up to and including prefix ARGth occurrence of CHAR.
Goes backward if ARG is negative; error if CHAR not found.
</p>
<a name="index-kview_003aset_002dlabel_002dseparator"></a>
</dd>
<dt><code>kview:set-label-separator  <kbd>{C-c M-l}</kbd></code></dt>
<dd><p>Set the LABEL-SEPARATOR (a string) between labels and cell contents for
the current kview.  With optional prefix arg SET-DEFAULT-P, the default
separator value used for new outlines is also set to this new value.
</p>
<a name="index-kview_003aset_002dlabel_002dtype"></a>
</dd>
<dt><code>kview:set-label-type  <kbd>{C-c C-l}</kbd></code></dt>
<dd><p>Change kview&rsquo;s label display type to NEW-TYPE, updating all displayed labels.
See documentation for the <code>kview:default-label-type</code> variable,
for valid values of NEW-TYPE.
</p>
<a name="index-kvspec_003aactivate-1"></a>
</dd>
<dt><code>kvspec:activate  <kbd>{C-c C-v}</kbd></code></dt>
<dd><p>Activate optional VIEW-SPEC or existing view specification over the
current koutline.  VIEW-SPEC must be a string.  See
&lsquo;<samp>&lt;<code>${hyperb:dir}</code>/kotl/EXAMPLE.kotl, 2b17=048&gt;</samp>&rsquo; for details
on valid view specs.
</p>
<a name="index-kvspec_003atoggle_002dblank_002dlines-1"></a>
</dd>
<dt><code>kvspec:toggle-blank-lines <kbd>{C-c b}</kbd></code></dt>
<dd><p>Toggle blank lines between cells on or off.
</p>
</dd>
</dl>


<hr>
<a name="Smart-Key-Reference"></a>
<div class="header">
<p>
Next: <a href="#Suggestion-or-Bug-Reporting" accesskey="n" rel="next">Suggestion or Bug Reporting</a>, Previous: <a href="#Koutliner-Keys" accesskey="p" rel="prev">Koutliner Keys</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Smart-Key-Reference-1"></a>
<h2 class="appendix">Appendix E Smart Key Reference</h2>

<p>This appendix documents Hyperbole&rsquo;s context-sensitive Smart Key
operations.  It is quite extensive and is meant for reference rather
than sequential reading.  See <a href="#Smart-Keys">Smart Keys</a>, for a description of the
Smart Keys.  That section also describes how to get context-sensitive
Smart Key help, with which you can explore Smart Key operation bit by
bit.
</p>
<p>What a Smart Key does depends on the context in which it is used.
Smart Key operations are context-sensitive.  Contexts are defined by
logic conditionals, e.g. when depressed here, if this is true, etc.
Each Smart Key context is listed in the order in which it will be
checked.  The first matching context is always the one applied.
Within each context, the actions performed by the Action and Assist
Keys are given.
</p>
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">&bull; <a href="#Smart-Mouse-Keys" accesskey="1">Smart Mouse Keys</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Keyboard-Keys" accesskey="2">Smart Keyboard Keys</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
</table>

<hr>
<a name="Smart-Mouse-Keys"></a>
<div class="header">
<p>
Next: <a href="#Smart-Keyboard-Keys" accesskey="n" rel="next">Smart Keyboard Keys</a>, Previous: <a href="#Smart-Key-Reference" accesskey="p" rel="prev">Smart Key Reference</a>, Up: <a href="#Smart-Key-Reference" accesskey="u" rel="up">Smart Key Reference</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Smart-Mouse-Keys-1"></a>
<h3 class="section">E.1 Smart Mouse Keys</h3>

<a name="index-Smart-Mouse-Keys"></a>
<p>The contexts and actions in this section, like drags and modeline
clicks, apply only if you have mouse support within Hyperbole.  The
Smart Key operations in <a href="#Smart-Keyboard-Keys">Smart Keyboard Keys</a>, apply to both mouse
and keyboard Smart Key usage.
</p>
<p>The following section documents what the Smart Mouse Keys do in each
context, with the contexts listed in decreasing order of priority,
i.e. the first context to match is the one that is used.  If no
matching mouse key context is found, then the keyboard key contexts
are searched in order.
</p>
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">&bull; <a href="#Minibuffer-Menu-Activation" accesskey="1">Minibuffer Menu Activation</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Thing-Selection" accesskey="2">Thing Selection</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Side_002dby_002dSide-Window-Resizing" accesskey="3">Side-by-Side Window Resizing</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Modeline-Clicks-and-Drags" accesskey="4">Modeline Clicks and Drags</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Mouse-Drags-between-Windows" accesskey="5">Smart Mouse Drags between Windows</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Mouse-Drags-within-a-Window" accesskey="6">Smart Mouse Drags within a Window</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Mouse-Drags-outside-a-Window" accesskey="7">Smart Mouse Drags outside a Window</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
</table>

<hr>
<a name="Minibuffer-Menu-Activation"></a>
<div class="header">
<p>
Next: <a href="#Thing-Selection" accesskey="n" rel="next">Thing Selection</a>, Previous: <a href="#Smart-Mouse-Keys" accesskey="p" rel="prev">Smart Mouse Keys</a>, Up: <a href="#Smart-Mouse-Keys" accesskey="u" rel="up">Smart Mouse Keys</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Minibuffer-Menu-Activation-1"></a>
<h4 class="subsection">E.1.1 Minibuffer Menu Activation</h4>

<a name="index-menu_002c-top_002dlevel-1"></a>
<a name="index-minibuffer-menu-1"></a>
<a name="index-buffer-menu-1"></a>
<a name="index-minibuffer_002c-buffer-menu"></a>
<a name="index-minibuffer_002c-default-actions"></a>
<a name="index-jump-menu-1"></a>
<a name="index-minibuffer_002c-jump-menu"></a>
<a name="index-inactive-minibuffer"></a>
<a name="index-action_002dkey_002dminibuffer_002dfunction"></a>
<a name="index-assist_002dkey_002dminibuffer_002dfunction"></a>
<div class="format">
<pre class="format">When clicked within an inactive minibuffer:
  ACTION KEY
     The Hyperbole minibuffer menu is displayed for selection, by default.
     The variable <code>action-key-minibuffer-function</code> controls this behavior.
  ASSIST KEY
     The buffer, window and frame jump menu is displayed for selection, by default.
     You can jump to buffers categorized by major mode, jump to windows by buffer
     name, or to frames by name.  Manage your windows and frames quickly with this
     menu as well.  This is the same menu that a click in a blank area of the
     modeline displays by default since they are typically so close together.  The
     variable <code>assist-key-minibuffer-function</code> controls this behavior.
</pre></div>

<hr>
<a name="Thing-Selection"></a>
<div class="header">
<p>
Next: <a href="#Side_002dby_002dSide-Window-Resizing" accesskey="n" rel="next">Side-by-Side Window Resizing</a>, Previous: <a href="#Minibuffer-Menu-Activation" accesskey="p" rel="prev">Minibuffer Menu Activation</a>, Up: <a href="#Smart-Mouse-Keys" accesskey="u" rel="up">Smart Mouse Keys</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Thing-Selection-1"></a>
<h4 class="subsection">E.1.2 Thing Selection</h4>

<a name="index-thing"></a>
<a name="index-list"></a>
<a name="index-comment"></a>
<a name="index-string"></a>
<a name="index-array"></a>
<a name="index-vector"></a>
<a name="index-set"></a>
<a name="index-function"></a>
<a name="index-markup-pair"></a>
<div class="format">
<pre class="format">In a programming or markup language buffer, when pressed/clicked at
the start or end of a delimited thing (including lists, comments,
strings, arrays/vectors, sets, functions and markup pair tags in a
markup language), and not at the end of a line:
  ACTION KEY
     Marks the thing for editing.
  ASSIST KEY
     Marks and kills the thing for yanking elsewhere.
</pre></div>

<p>Note that the press must be on the first character of the delimiter of
the thing.
</p>
<a name="index-Smart-Mouse-Key"></a>
<a name="index-Action-Mouse-Key"></a>
<a name="index-Assist-Mouse-Key"></a>
<a name="index-drag-1"></a>
<a name="index-copy-and-yank"></a>
<a name="index-kill-and-yank"></a>
<a name="index-yanking"></a>
<a name="index-pasting-a-region"></a>
<p>There are also <em>drag</em> actions that work on delimited things.
Delimited things include parenthesized lists, single and double quoted
strings, bracketed arrays/vectors, sets with braces, programming
language functions and markup pair tags (e.g. &lt;div&gt;
&lt;/div&gt; in HTML).
</p>
<p>If no region is selected when the Action Mouse Key is dragged from a
thing delimiter to another location, it copies the delimited thing to
the release point of the drag.  The release location may be in the
same or a different buffer but if in the same buffer it must be
outside of the delimited thing itself.  Similarly, the Assist Mouse
Key kills (cuts) the delimited thing at its original location and
yanks (pastes) it at the new location.
</p>
<p>The start of the drag must be on the first character of the starting
or ending delimiter.  For strings and comments, the drag must start on
the first line of the thing.
</p>
<p>Experiment with these drag actions and you will quickly find them easy
to use and indispensable.
</p>
<hr>
<a name="Side_002dby_002dSide-Window-Resizing"></a>
<div class="header">
<p>
Next: <a href="#Modeline-Clicks-and-Drags" accesskey="n" rel="next">Modeline Clicks and Drags</a>, Previous: <a href="#Thing-Selection" accesskey="p" rel="prev">Thing Selection</a>, Up: <a href="#Smart-Mouse-Keys" accesskey="u" rel="up">Smart Mouse Keys</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Side_002dby_002dSide-Window-Resizing-1"></a>
<h4 class="subsection">E.1.3 Side-by-Side Window Resizing</h4>

<a name="index-drag_002c-side-edge"></a>
<a name="index-side-drag"></a>
<div class="format">
<pre class="format">If dragged from a side-by-side window edge or from the immediate left of
a vertical scroll bar:
  ACTION KEY or ASSIST KEY
     Resizes adjacent window sides to the point of the drag release.
</pre></div>

<hr>
<a name="Modeline-Clicks-and-Drags"></a>
<div class="header">
<p>
Next: <a href="#Smart-Mouse-Drags-between-Windows" accesskey="n" rel="next">Smart Mouse Drags between Windows</a>, Previous: <a href="#Side_002dby_002dSide-Window-Resizing" accesskey="p" rel="prev">Side-by-Side Window Resizing</a>, Up: <a href="#Smart-Mouse-Keys" accesskey="u" rel="up">Smart Mouse Keys</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Modeline-Clicks-and-Drags-1"></a>
<h4 class="subsection">E.1.4 Modeline Clicks and Drags</h4>

<a name="index-click_002c-modeline"></a>
<a name="index-modeline-click"></a>
<a name="index-modeline-drag"></a>
<a name="index-action_002dkey_002dmodeline_002dfunction-1"></a>
<a name="index-assist_002dkey_002dmodeline_002dfunction-1"></a>
<div class="format">
<pre class="format">If depressed within a window modeline:
  ACTION MOUSE KEY
     (1) clicked on the first blank character of a window&rsquo;s modeline,
         the window&rsquo;s buffer is buried (placed at the bottom of the
         buffer list);
     (2) clicked on the right edge of a window&rsquo;s modeline, the Info
         buffer is displayed, or if it is already displayed and the
         modeline clicked upon belongs to a window displaying Info,
         the Info buffer is hidden;
     (3) clicked on the buffer id of a window&rsquo;s modeline, dired is run
         on the current directory, replacing the window&rsquo;s buffer;
         successive clicks walk up the directory tree
     (4) clicked anywhere within the middle of a window&rsquo;s modeline,
         the function given by <code>action-key-modeline-function</code> is
         called;
     (5) dragged vertically from a modeline to within a window, the
         modeline is moved to the point of the drag release, thereby
         resizing its window and potentially its vertically neighboring
         windows;
     (6) dragged other than straight vertically from a modeline to another
         window, duplicate the modeline&rsquo;s window buffer to the window of
         release;
     (7) dragged from a bottommost modeline when the frame has a non-nil
         <code>drag-with-mode-line</code> property, then move the frame until
         release of the Action Mouse Key;
     (8) otherwide, dragged from a another modeline to outside of
         Emacs (MacOS only), create a new frame sized to match the
         selected window with the same buffer.
</pre></div>
<div class="format">
<pre class="format">  ASSIST MOUSE KEY
     (1) clicked on the first blank character of a window&rsquo;s modeline,
         the bottom buffer in the buffer list is unburied and placed in
         the window;
     (2) clicked on the right edge of a window&rsquo;s modeline, the summary
         of Smart Key behavior is displayed, or if it is already
         displayed and the modeline clicked upon belongs to a window
         displaying the summary, the summary buffer is hidden;
     (3) clicked on the buffer id of a window&rsquo;s modeline, the next
         buffer in sequence is displayed in the window;
     (4) clicked anywhere within the middle of a window&rsquo;s modeline,
         the function given by <code>assist-key-modeline-function</code> is
         called;
     (5) dragged vertically from a modeline to within a window, the
         modeline is moved to the point of the drag release, thereby
         resizing its window and potentially its vertically neighboring
         windows;
     (6) dragged other than straight vertically from a modeline to another
         window, swap buffers in the two windows;
     (7) dragged from a bottommost modeline when the frame has a non-nil
         <code>drag-with-mode-line</code> property, then move the frame until
         release of the Action Mouse Key;
     (8) dragged from a modeline to outside of Emacs (MacOS only),
         create a new frame sized to match the selected window with
         the same buffer.  If there is only one window in the source
         frame or if <code>hycontrol-keep-window-flag</code> is non-nil,
         leave the original window and just clone it into the new
         frame; otherwise, delete the original window.
</pre></div>

<div class="format">
<pre class="format">If dragged from a window and released within a window modeline:
  ACTION KEY
     (1) If depress was on a buffer name in Buffer-menu/ibuffer mode or on
         a file/directory in dired mode, splits the release window and displays
         the item in the original release window.
     (2) Otherwise, splits the release window and displays the depress window&rsquo;s
         buffer in the original release window.
  ASSIST KEY
     Swaps buffers in the two windows.
</pre></div>

<hr>
<a name="Smart-Mouse-Drags-between-Windows"></a>
<div class="header">
<p>
Next: <a href="#Smart-Mouse-Drags-within-a-Window" accesskey="n" rel="next">Smart Mouse Drags within a Window</a>, Previous: <a href="#Modeline-Clicks-and-Drags" accesskey="p" rel="prev">Modeline Clicks and Drags</a>, Up: <a href="#Smart-Mouse-Keys" accesskey="u" rel="up">Smart Mouse Keys</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Smart-Mouse-Drags-between-Windows-1"></a>
<h4 class="subsection">E.1.5 Smart Mouse Drags between Windows</h4>

<a name="index-active-region"></a>
<a name="index-copy-and-yank-1"></a>
<a name="index-kill-and-yank-1"></a>
<a name="index-yanking-1"></a>
<a name="index-pasting-a-region-1"></a>
<div class="format">
<pre class="format">If an active (highlighted) region exists within the editor:
  ACTION KEY
     Copies and yanks (pastes) the region to the release point in a
     different window.
  ASSIST KEY
     Kills (cuts) and yanks (pastes) the region to the release point
     in a different window.
</pre></div>

<div class="format">
<pre class="format">Otherwise, if dragged from inside one window to another:
  ACTION KEY
     (1) If depress was on a buffer name in Buffer-menu/ibuffer mode or on
         a file/directory in dired mode, displays the item in window of release.
         See <code>hmouse-drag-item-mode-forms</code> for how to allow for draggable
         items in other modes.
     (2) Otherwise, creates a new link button at the drag start location, linked
         to the drag end location.  If the drag start position is within a button,
         this modifies the button to link to the drag end location.
  ASSIST KEY
     Swap buffers in the two windows.
</pre></div>

<hr>
<a name="Smart-Mouse-Drags-within-a-Window"></a>
<div class="header">
<p>
Next: <a href="#Smart-Mouse-Drags-outside-a-Window" accesskey="n" rel="next">Smart Mouse Drags outside a Window</a>, Previous: <a href="#Smart-Mouse-Drags-between-Windows" accesskey="p" rel="prev">Smart Mouse Drags between Windows</a>, Up: <a href="#Smart-Mouse-Keys" accesskey="u" rel="up">Smart Mouse Keys</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Smart-Mouse-Drags-within-a-Window-1"></a>
<h4 class="subsection">E.1.6 Smart Mouse Drags within a Window</h4>

<a name="index-active-region-1"></a>
<a name="index-region_002c-active"></a>
<a name="index-drag_002c-with-region-1"></a>
<div class="format">
<pre class="format">If a region is active and a drag occurs within a single buffer/window:
  ACTION KEY
     Restores region to before Action Key drag and signals an error.
  ASSIST KEY
     Restores region to before Action Key drag and signals an error.
</pre></div>

<a name="index-drag_002c-horizontal-1"></a>
<a name="index-horizontal-drag-1"></a>
<a name="index-hmouse_002dx_002ddrag_002dsensitivity"></a>
<div class="format">
<pre class="format">(Note that <code>hmouse-x-drag-sensitivity</code> sets the minimal horizontal
movement which registers a drag).  If dragged horizontally within a
single window from anywhere but a thing delimiter:
  ACTION KEY
     Splits the current window, adding a window below.
  ASSIST KEY
     Deletes the current window if it is not the sole window in the
     current frame.
</pre></div>

<a name="index-drag_002c-vertical-1"></a>
<a name="index-vertical-drag-1"></a>
<a name="index-hmouse_002dy_002ddrag_002dsensitivity"></a>
<div class="format">
<pre class="format">(Note that <code>hmouse-y-drag-sensitivity</code> sets the minimal vertical
movement which registers a drag).  If dragged vertically within a
single window from anywhere but a thing delimiter:
  ACTION KEY
     Splits the current window, adding a window to the right.
  ASSIST KEY
     Deletes the current window if it is not the sole window in the
     current frame.
</pre></div>

<a name="index-drag_002c-diagonal-1"></a>
<a name="index-diagonal-drag-1"></a>
<a name="index-hmouse_002dx_002ddiagonal_002dsensitivity"></a>
<a name="index-hmouse_002dy_002ddiagonal_002dsensitivity"></a>
<div class="format">
<pre class="format">If dragged diagonally within a single window while depressed
(&lsquo;hmouse-x-diagonal-sensitivity&rsquo; and &lsquo;hmouse-y-diagonal-sensitivity&rsquo; set
the minimal diagonal movements which register a drag):
  ACTION KEY
     Saves the window configuration for the selected frame onto a ring
     of window configurations.
  ASSIST KEY
     Restores the prior window configuration from the ring.  A prefix
     argument N specifies the Nth prior configuration from the ring.
</pre></div>
     
<hr>
<a name="Smart-Mouse-Drags-outside-a-Window"></a>
<div class="header">
<p>
Previous: <a href="#Smart-Mouse-Drags-within-a-Window" accesskey="p" rel="prev">Smart Mouse Drags within a Window</a>, Up: <a href="#Smart-Mouse-Keys" accesskey="u" rel="up">Smart Mouse Keys</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Smart-Mouse-Drags-outside-a-Window-1"></a>
<h4 class="subsection">E.1.7 Smart Mouse Drags outside a Window</h4>

<a name="index-hmouse_002ddrag_002ditem_002dmode_002dforms"></a>
<a name="index-hycontrol_002dkeep_002dwindow_002dflag-1"></a>
<a name="index-dragging-items"></a>
<a name="index-dragging-outside-Emacs"></a>
<a name="index-window_002c-clone-2"></a>
<a name="index-clone-window-2"></a>
<a name="index-window_002c-move"></a>
<a name="index-move-window"></a>
<div class="format">
<pre class="format">If dragged from an Emacs window to outside of Emacs:
  ACTION KEY
     (1) If depress was on a buffer name in Buffer-menu/ibuffer mode or on
         a file/directory in dired mode, display the item in a new frame.
         See <code>hmouse-drag-item-mode-forms</code> for how to allow for draggable
         items in other modes.
     (2) If depress was anywhere else, create a new frame sized to match the
         selected window with the same buffer.
  ASSIST KEY
     Create a new frame sized to match the selected window with the same buffer.
     If there is only one window in the source frame or if <code>hycontrol-keep-window-flag</code>
     is non-nil, leave the original window and just clone it into the new frame;
     otherwise, delete the original window.
</pre></div>

<hr>
<a name="Smart-Keyboard-Keys"></a>
<div class="header">
<p>
Previous: <a href="#Smart-Mouse-Keys" accesskey="p" rel="prev">Smart Mouse Keys</a>, Up: <a href="#Smart-Key-Reference" accesskey="u" rel="up">Smart Key Reference</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Smart-Keyboard-Keys-1"></a>
<h3 class="section">E.2 Smart Keyboard Keys</h3>

<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Company-Mode" accesskey="1">Smart Key - Company Mode</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Treemacs" accesskey="2">Smart Key - Treemacs</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Dired-Sidebar-Mode" accesskey="3">Smart Key - Dired Sidebar Mode</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Emacs-Pushbuttons" accesskey="4">Smart Key - Emacs Pushbuttons</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Argument-Completion" accesskey="5">Smart Key - Argument Completion</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-ID-Edit-Mode" accesskey="6">Smart Key - ID Edit Mode</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Emacs-Cross_002dreferences-_0028Xrefs_0029" accesskey="7">Smart Key - Emacs Cross-references (Xrefs)</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Smart-Scrolling" accesskey="8">Smart Key - Smart Scrolling</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Smart-Menus" accesskey="9">Smart Key - Smart Menus</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Dired-Mode">Smart Key - Dired Mode</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Hyperbole-Buttons">Smart Key - Hyperbole Buttons</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-View-Mode">Smart Key - View Mode</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Helm-Mode">Smart Key - Helm Mode</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Delimited-Things">Smart Key - Delimited Things</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-The-Koutliner">Smart Key - The Koutliner</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-RDB-Mode">Smart Key - RDB Mode</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Help-Buffers">Smart Key - Help Buffers</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Bookmark-Mode">Smart Key - Bookmark Mode</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Pages-Directory-Mode">Smart Key - Pages Directory Mode</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Python-Source-Code">Smart Key - Python Source Code</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Identifier-Menu-Mode">Smart Key - Identifier Menu Mode </a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-C-Source-Code">Smart Key - C Source Code</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-C_002b_002b-Source-Code">Smart Key - C++ Source Code</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Assembly-Source-Code">Smart Key - Assembly Source Code</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Lisp-Source-Code">Smart Key - Lisp Source Code</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Java-Source-Code">Smart Key - Java Source Code</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-JavaScript-Source-Code">Smart Key - JavaScript Source Code</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Objective_002dC-Source-Code">Smart Key - Objective-C Source Code</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Fortran-Source-Code">Smart Key - Fortran Source Code</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Occurrence-Matches">Smart Key - Occurrence Matches</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Calendar-Mode">Smart Key - Calendar Mode</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Man-Page-Apropos">Smart Key - Man Page Apropos</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Emacs-Outline-Mode">Smart Key - Emacs Outline Mode</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Info-Manuals">Smart Key - Info Manuals</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Email-Readers">Smart Key - Email Readers</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-GNUS-Newsreader">Smart Key - GNUS Newsreader</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Buffer-Menus">Smart Key - Buffer Menus</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Tar-File-Mode">Smart Key - Tar File Mode</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Man-Pages">Smart Key - Man Pages</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-WWW-URLs">Smart Key - WWW URLs</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-HyRolo-Match-Buffers">Smart Key - HyRolo Match Buffers</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Image-Thumbnails">Smart Key - Image Thumbnails</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Gomoku-Game">Smart Key - Gomoku Game</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Magit-Mode">Smart Key - Magit Mode</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-The-OO_002dBrowser">Smart Key - The OO-Browser</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">&bull; <a href="#Smart-Key-_002d-Default-Context">Smart Key - Default Context</a>:</td><td>&nbsp;&nbsp;</td><td align="left" valign="top">
</td></tr>
</table>

<hr>
<a name="Smart-Key-_002d-Company-Mode"></a>
<div class="header">
<p>
Next: <a href="#Smart-Key-_002d-Treemacs" accesskey="n" rel="next">Smart Key - Treemacs</a>, Previous: <a href="#Smart-Keyboard-Keys" accesskey="p" rel="prev">Smart Keyboard Keys</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart Keyboard Keys</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Smart-Key-_002d-Company-Mode-1"></a>
<h4 class="subsection">E.2.1 Smart Key - Company Mode</h4>

<a name="index-company_002dmode"></a>
<a name="index-completion-2"></a>
<p>Company mode is an extensive in-buffer completion framework, often used to complete programming identifiers.
</p>
<div class="format">
<pre class="format">When company-mode is active:
  ACTION KEY
     Displays selected item&rsquo;s definition.
  ASSIST KEY
     Displays the documentation, if any, for the selected item.
</pre></div>


<hr>
<a name="Smart-Key-_002d-Treemacs"></a>
<div class="header">
<p>
Next: <a href="#Smart-Key-_002d-Dired-Sidebar-Mode" accesskey="n" rel="next">Smart Key - Dired Sidebar Mode</a>, Previous: <a href="#Smart-Key-_002d-Company-Mode" accesskey="p" rel="prev">Smart Key - Company Mode</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart Keyboard Keys</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Smart-Key-_002d-Treemacs-1"></a>
<h4 class="subsection">E.2.2 Smart Key - Treemacs</h4>

<a name="index-Treemacs-1"></a>
<p>Treemacs is an add-on Emacs package that offers a fixed, per-frame, graphical
window for hierarchically browsing and operating upon directories, files and
programming tags within files.  Use the Emacs package manager to install it and
then invoke it with <kbd>{M-x treemacs <span class="key">RET</span>}</kbd> and quit with <kbd>{q}</kbd>.
</p>
<p>Treemacs items may be dragged with the Action Key to other windows for display.
See <a href="#Displaying-File-and-Buffer-Items">Displaying File and Buffer Items</a>.
</p>
<div class="format">
<pre class="format">When in a Treemacs file browser buffer:
  ACTION KEY or ASSIST KEY
     (1) on an entry icon, the treemacs TAB command is run to expand and
         collapse the entry;
     (2) elsewhere within an entry line, the item is displayed for editing,
         normally in another window;
     (3) at the end of an entry line: if an Action Key press, invokes
         <code>action-key-eol-function</code>, typically to scroll up proportionally;
         if an Assist Key press, invokes <code>assist-key-eol-function</code>, typically
         to scroll down proportionally;
     (4) on the first line of the buffer (other than the end of line),
         dired is run on the current directory of this Treemacs;
     (5) at the end of the first or last line of the buffer,
         this Treemacs invocation is quit.
</pre></div>

<hr>
<a name="Smart-Key-_002d-Dired-Sidebar-Mode"></a>
<div class="header">
<p>
Next: <a href="#Smart-Key-_002d-Emacs-Pushbuttons" accesskey="n" rel="next">Smart Key - Emacs Pushbuttons</a>, Previous: <a href="#Smart-Key-_002d-Treemacs" accesskey="p" rel="prev">Smart Key - Treemacs</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart Keyboard Keys</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Smart-Key-_002d-Dired-Sidebar-Mode-1"></a>
<h4 class="subsection">E.2.3 Smart Key - Dired Sidebar Mode</h4>

<a name="index-dired_002dsidebar_002dmode"></a>
<p>Dired-sidebar is an add-on Emacs package that puts dired in a sidebar
and optionally integrates with vareous other packages.  Use the Emacs
package manager to install it and then invoke it with
<kbd>{M-x dired-sidebar-toggle-sidebar <span class="key">RET</span>}</kbd> and quit with <kbd>{q}</kbd>.
</p>
<div class="format">
<pre class="format">When in a dired-sidebar buffer:
  ACTION KEY or ASSIST KEY
     (1) within an entry line, the item is displayed for editing,
         normally in another window, or if it is a directory and
         &lsquo;dired-sidebar-cycle-subtree-on-click&rsquo; is t it will expand
         and collapse the entry
     (2) at the end of an entry line: invoke &lsquo;action-key-eol-function&rsquo;,
         typically to scroll up proportionally, if an Action Key press; invoke
         &lsquo;assist-key-eol-function&rsquo;, typically to scroll down proportionally,
         if an Asisst Key press;
     (3) on the first line of the buffer (other than the end of line),
         dired is run on the current directory of this dired-sidebar;
     (4) at the end of the first or last line of the buffer,
         this dired-sidebar invocation is hidden.
</pre></div>

<hr>
<a name="Smart-Key-_002d-Emacs-Pushbuttons"></a>
<div class="header">
<p>
Next: <a href="#Smart-Key-_002d-Argument-Completion" accesskey="n" rel="next">Smart Key - Argument Completion</a>, Previous: <a href="#Smart-Key-_002d-Dired-Sidebar-Mode" accesskey="p" rel="prev">Smart Key - Dired Sidebar Mode</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart Keyboard Keys</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Smart-Key-_002d-Emacs-Pushbuttons-1"></a>
<h4 class="subsection">E.2.4 Smart Key - Emacs Pushbuttons</h4>

<div class="format">
<pre class="format">When over an Emacs pushbutton:
  ACTION KEY
     Performs the button action
  ASSIST KEY
     Displays the help text for the button, if any.
</pre></div>

<hr>
<a name="Smart-Key-_002d-Argument-Completion"></a>
<div class="header">
<p>
Next: <a href="#Smart-Key-_002d-ID-Edit-Mode" accesskey="n" rel="next">Smart Key - ID Edit Mode</a>, Previous: <a href="#Smart-Key-_002d-Emacs-Pushbuttons" accesskey="p" rel="prev">Smart Key - Emacs Pushbuttons</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart Keyboard Keys</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Smart-Key-_002d-Argument-Completion-1"></a>
<h4 class="subsection">E.2.5 Smart Key - Argument Completion</h4>

<a name="index-Smart-Keyboard-Keys"></a>
<div class="format">
<pre class="format">When prompting for a Hyperbole argument, a press in the minibuffer:
  ACTION KEY
     Accepts the current minibuffer argument.
  ASSIST KEY
     Offers completions for the current minibuffer argument.
</pre></div>

<a name="index-completion-3"></a>
<div class="format">
<pre class="format">When reading a Hyperbole menu item or an argument with completion:
  ACTION KEY
     Returns the value selected at point if any, else nil.  If the
     value is the same as the contents of the minibuffer, this value is
     accepted as the argument for which the minibuffer is presently
     prompting; otherwise, the minibuffer is erased and the value is
     inserted there, for inspection by the user.
  ASSIST KEY
     Displays Hyperbole menu item help when an item is selected.
</pre></div>

<hr>
<a name="Smart-Key-_002d-ID-Edit-Mode"></a>
<div class="header">
<p>
Next: <a href="#Smart-Key-_002d-Emacs-Cross_002dreferences-_0028Xrefs_0029" accesskey="n" rel="next">Smart Key - Emacs Cross-references (Xrefs)</a>, Previous: <a href="#Smart-Key-_002d-Argument-Completion" accesskey="p" rel="prev">Smart Key - Argument Completion</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart Keyboard Keys</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Smart-Key-_002d-ID-Edit-Mode-1"></a>
<h4 class="subsection">E.2.6 Smart Key - ID Edit Mode</h4>
<div class="format">
<pre class="format">If in ID Edit mode (a package within InfoDock, not included in
Hyperbole, that supports rapid marking, killing, copying, yanking and
display-management):
  ACTION KEY or ASSIST KEY
     Yanks (pastes) last selected region at point.
</pre></div>

<hr>
<a name="Smart-Key-_002d-Emacs-Cross_002dreferences-_0028Xrefs_0029"></a>
<div class="header">
<p>
Next: <a href="#Smart-Key-_002d-Smart-Scrolling" accesskey="n" rel="next">Smart Key - Smart Scrolling</a>, Previous: <a href="#Smart-Key-_002d-ID-Edit-Mode" accesskey="p" rel="prev">Smart Key - ID Edit Mode</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart Keyboard Keys</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Smart-Key-_002d-Emacs-Cross_002dreferences-_0028Xrefs_0029-1"></a>
<h4 class="subsection">E.2.7 Smart Key - Emacs Cross-references (Xrefs)</h4>

<div class="format">
<pre class="format">When over an Emacs cross-reference:
  ACTION KEY
     Follows the cross-reference to its source definition in another window.
  ASSIST KEY
     Displays the cross-reference definition in another window but
     stays in the current window.
</pre></div>

<hr>
<a name="Smart-Key-_002d-Smart-Scrolling"></a>
<div class="header">
<p>
Next: <a href="#Smart-Key-_002d-Smart-Menus" accesskey="n" rel="next">Smart Key - Smart Menus</a>, Previous: <a href="#Smart-Key-_002d-Emacs-Cross_002dreferences-_0028Xrefs_0029" accesskey="p" rel="prev">Smart Key - Emacs Cross-references (Xrefs)</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart Keyboard Keys</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Smart-Key-_002d-Smart-Scrolling-1"></a>
<h4 class="subsection">E.2.8 Smart Key - Smart Scrolling</h4>

<a name="index-smart_002dscroll_002dproportional"></a>
<a name="index-proportional-scrolling-1"></a>
<a name="index-scrolling-1"></a>
<a name="index-click_002c-end-of-line"></a>
<a name="index-end-of-line-click"></a>
<a name="index-action_002dkey_002deol_002dfunction"></a>
<a name="index-assist_002dkey_002deol_002dfunction"></a>
<div class="format">
<pre class="format">When pressed at the end of a line but not the end of a buffer:
  ACTION KEY
     Calls the function given by <code>action-key-eol-function</code> whose
     default value is <code>smart-scroll-up</code>.  This scrolls up according
     to the value of <code>smart-scroll-proportional</code>.  If
     <code>smart-scroll-proportional</code> is nil or if point is on the top
     window line, it scrolls up (forward) a windowful.  Otherwise, it tries
     to bring the current line to the top of the window, leaving point at
     the end of the line and returning t if scrolled, nil if not.
</pre></div>
<div class="format">
<pre class="format">  ASSIST KEY
     Calls the function given by <code>assist-key-eol-function</code> whose
     default value is <code>smart-scroll-down</code>.  This scrolls down according
     to the value of <code>smart-scroll-proportional</code>.  If
     <code>smart-scroll-proportional</code> is nil or if point is on the bottom
     window line, it scrolls down (backward) a windowful.  Otherwise, it tries
     to bring the current line to the bottom of the window, leaving point at
     the end of the line and returning t if scrolled, nil if not.
</pre></div>

<hr>
<a name="Smart-Key-_002d-Smart-Menus"></a>
<div class="header">
<p>
Next: <a href="#Smart-Key-_002d-Dired-Mode" accesskey="n" rel="next">Smart Key - Dired Mode</a>, Previous: <a href="#Smart-Key-_002d-Smart-Scrolling" accesskey="p" rel="prev">Smart Key - Smart Scrolling</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart Keyboard Keys</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Smart-Key-_002d-Smart-Menus-1"></a>
<h4 class="subsection">E.2.9 Smart Key - Smart Menus</h4>

<p>Smart Menus are an older in-buffer menu system that worked on dumb
terminals and pre-dated Emacs&rsquo; own dumb terminal menu support.  They
are included with InfoDock (which is no longer maintained) and are not
available separately.  They are not a part of Hyperbole and are not
necesary for its use.
</p>
<div class="format">
<pre class="format">When pressed on a Smart Menu item (this is an older in-buffer menu
  system that pre-dates Emacs&rsquo; own menus):
  ACTION KEY
    Activates the item.
  ASSIST KEY
    Displays help for the item.
</pre></div>

<a name="index-hkey_002dalways_002ddisplay_002dmenu"></a>
<a name="index-Smart-Menu"></a>
<div class="format">
<pre class="format">If the Smart Menu package (part of InfoDock) has been loaded and
&lsquo;hkey-always-display-menu&rsquo; is non-nil:
  ACTION KEY or ASSIST KEY
     Pops up a window with a Smart Menu of commands.
     The menu displayed is selected by (smart-menu-choose-menu).
</pre></div>

<hr>
<a name="Smart-Key-_002d-Dired-Mode"></a>
<div class="header">
<p>
Next: <a href="#Smart-Key-_002d-Hyperbole-Buttons" accesskey="n" rel="next">Smart Key - Hyperbole Buttons</a>, Previous: <a href="#Smart-Key-_002d-Smart-Menus" accesskey="p" rel="prev">Smart Key - Smart Menus</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart Keyboard Keys</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Smart-Key-_002d-Dired-Mode-1"></a>
<h4 class="subsection">E.2.10 Smart Key - Dired Mode</h4>
<a name="index-click_002c-dired"></a>
<a name="index-drag_002c-dired"></a>
<a name="index-dired-browsing"></a>
<a name="index-DisplayHere-mode"></a>
<div class="format">
<pre class="format">If pressed within a dired-mode (directory editor) buffer:
  ACTION KEY
     (1) within an entry line, the selected file/directory is displayed
         for editing, normally in another window but if an entry has been dragged
         for display in another window, then this entry is displayed in the current
         window (DisplayHere minor mode is shown in the mode-line; use <kbd>{g}</kbd> to
         disable it)
     (2) on the first line of the buffer:
         (a) within the leading whitespace, then if any deletes are to be
             performed, they are executed after user verification; otherwise,
             nothing is done;
         (b) otherwise, dired is run in another window on the ancestor directory
             of the current directory path up through the location of point;
             if point is before the first character, then the / root directory
             is used.
     (3) on or after the last line in the buffer or at the end of the first line,
         this dired invocation is quit.
</pre></div>
<div class="format">
<pre class="format">  ASSIST KEY
     (1) on a ~ character, all backup files in the directory are marked for deletion;
     (2) on a # character, all auto-save files in the directory are marked for
         deletion;
     (3) anywhere else within an entry line, the current entry is marked for deletion;
     (4) on or after the last line in the buffer or at the end of the first line,
         all delete marks on all entries are undone.
</pre></div>

<hr>
<a name="Smart-Key-_002d-Hyperbole-Buttons"></a>
<div class="header">
<p>
Next: <a href="#Smart-Key-_002d-View-Mode" accesskey="n" rel="next">Smart Key - View Mode</a>, Previous: <a href="#Smart-Key-_002d-Dired-Mode" accesskey="p" rel="prev">Smart Key - Dired Mode</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart Keyboard Keys</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Smart-Key-_002d-Hyperbole-Buttons-1"></a>
<h4 class="subsection">E.2.11 Smart Key - Hyperbole Buttons</h4>

<a name="index-click_002c-button"></a>
<a name="index-button-click"></a>
<div class="format">
<pre class="format">When pressed on a Hyperbole button:
  ACTION KEY
     Activates the button.
  ASSIST KEY
     Displays help for the button, typically a summary of its
     attributes.
</pre></div>

<hr>
<a name="Smart-Key-_002d-View-Mode"></a>
<div class="header">
<p>
Next: <a href="#Smart-Key-_002d-Helm-Mode" accesskey="n" rel="next">Smart Key - Helm Mode</a>, Previous: <a href="#Smart-Key-_002d-Hyperbole-Buttons" accesskey="p" rel="prev">Smart Key - Hyperbole Buttons</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart Keyboard Keys</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Smart-Key-_002d-View-Mode-1"></a>
<h4 class="subsection">E.2.12 Smart Key - View Mode</h4>

<a name="index-view-mode"></a>
<div class="format">
<pre class="format">If pressed within a buffer in View major or minor mode:
  ACTION KEY
     Scrolls the buffer forward a windowful.  If at the last line of the
     buffer, instead quits from view mode.
  ASSIST KEY
     Scrolls the buffer backward a windowful.
</pre></div>

<hr>
<a name="Smart-Key-_002d-Helm-Mode"></a>
<div class="header">
<p>
Next: <a href="#Smart-Key-_002d-Delimited-Things" accesskey="n" rel="next">Smart Key - Delimited Things</a>, Previous: <a href="#Smart-Key-_002d-View-Mode" accesskey="p" rel="prev">Smart Key - View Mode</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart Keyboard Keys</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Smart-Key-_002d-Helm-Mode-1"></a>
<h4 class="subsection">E.2.13 Smart Key - Helm Mode</h4>

<p>Because of the way helm is written, you may need a modified version of
helm for these Smart Key actions to work.  Try them in your own
version and if there are any issues, install helm from
<samp>github.com/rswgnu/helm</samp>. 
</p>
<a name="index-helm-mode"></a>
<a name="index-completion-4"></a>
<div class="format">
<pre class="format">If pressed within a buffer in helm major mode:
  ACTION KEY
     (1) at the end of the buffer, quits from helm and exits the minibuffer;
     (2) on a candidate line, performs the candidate&rsquo;s first action and
         remains in the minibuffer;
     (3) on the top, fixed header line, toggles display of the selected
         candidate&rsquo;s possible actions;
     (4) on an action list line, performs the action after exiting the
         minibuffer;
     (5) on a source section header, moves to the next source section or
         first if on last;
     (6) on a candidate separator line, does nothing;
     (7) in the minibuffer window, ends the helm session and performs the
         selected item&rsquo;s action.
  ASSIST KEY
     (1) at the end of the buffer, quits from helm and exits the minibuffer;
     (2) on a candidate line, display&rsquo;s the candidate&rsquo;s first action
         and remains in the minibuffer;
     (3) on the top, fixed header line, toggles display of the
         selected candidate&rsquo;s possible actions;
     (4) on an action list line, performs the action after exiting the
         minibuffer;
     (5) on a source section header, moves to the previous source
         section or last if on first;
     (6) on a candidate separator line, does nothing;
     (7) in the minibuffer window, ends the helm session and performs
         the selected item&rsquo;s action.
</pre></div>

<hr>
<a name="Smart-Key-_002d-Delimited-Things"></a>
<div class="header">
<p>
Next: <a href="#Smart-Key-_002d-The-Koutliner" accesskey="n" rel="next">Smart Key - The Koutliner</a>, Previous: <a href="#Smart-Key-_002d-Helm-Mode" accesskey="p" rel="prev">Smart Key - Helm Mode</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart Keyboard Keys</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Smart-Key-_002d-Delimited-Things-1"></a>
<h4 class="subsection">E.2.14 Smart Key - Delimited Things</h4>

<a name="index-thing-1"></a>
<a name="index-list-1"></a>
<a name="index-comment-1"></a>
<a name="index-string-1"></a>
<a name="index-array-1"></a>
<a name="index-vector-1"></a>
<a name="index-set-1"></a>
<a name="index-function-1"></a>
<a name="index-markup-pair-1"></a>
<div class="format">
<pre class="format">In a programming or markup language buffer, when pressed/clicked at
the start or end of a delimited thing (including lists, comments,
strings, arrays/vectors, sets, functions and markup pair tags in a
markup language), and not at the end of a line:
  ACTION KEY
     Marks the thing for editing.
  ASSIST KEY
     Marks and kills the thing for yanking elsewhere.
Note that the press must be on the first character of the delimiter of
the thing.

<a name="index-Smart-Mouse-Key-1"></a><a name="index-Action-Mouse-Key-1"></a><a name="index-Assist-Mouse-Key-1"></a><a name="index-drag-2"></a><a name="index-copy-and-yank-2"></a><a name="index-kill-and-yank-2"></a><a name="index-yanking-2"></a><a name="index-pasting-a-region-2"></a>There are also drag actions that work on delimited things.  If no
region is selected, when the Action Mouse Key is dragged from a thing
delimiter to another location, it copies the thing and yanks it at the
new location.  Similarly, the Assist Mouse Key kills the thing at its
original location and yanks it at the new location.
</pre></div>


<hr>
<a name="Smart-Key-_002d-The-Koutliner"></a>
<div class="header">
<p>
Next: <a href="#Smart-Key-_002d-RDB-Mode" accesskey="n" rel="next">Smart Key - RDB Mode</a>, Previous: <a href="#Smart-Key-_002d-Delimited-Things" accesskey="p" rel="prev">Smart Key - Delimited Things</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart Keyboard Keys</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Smart-Key-_002d-The-Koutliner-1"></a>
<h4 class="subsection">E.2.15 Smart Key - The Koutliner</h4>
<div class="format">
<pre class="format">When pressed within a Hyperbole Koutliner buffer (kotl-mode):
  ACTION KEY
     (1) at the end of the buffer, uncollapses and unhides all cells in
         the view;
     (2) within a cell, if its subtree is hidden then shows it,
         otherwise hides it;
     (3) between cells or within the read-only indentation region to the
         left of a cell, begins creation of a klink to some other
         outline cell; press the Action Key twice on another cell to
         select the link referent cell;
     (4) anywhere else, scrolls up a windowful.
</pre></div>
<div class="format">
<pre class="format">  ASSIST KEY
     (1) at the end of the buffer, collapses all cells and hides all
         non-level-one cells;
     (2) on a header line but not at the beginning or end, displays the
         properties of each following cell in the koutline, starting
         with the cell at point;
     (3) between cells or within the read-only indentation region to the
         left of a cell, prompts to move one tree to a new location in
         the outline; press the Action Key twice to select the tree to
         move and where to move it;
     (4) anywhere else, scrolls down a windowful.
</pre></div>

<hr>
<a name="Smart-Key-_002d-RDB-Mode"></a>
<div class="header">
<p>
Next: <a href="#Smart-Key-_002d-Help-Buffers" accesskey="n" rel="next">Smart Key - Help Buffers</a>, Previous: <a href="#Smart-Key-_002d-The-Koutliner" accesskey="p" rel="prev">Smart Key - The Koutliner</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart Keyboard Keys</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Smart-Key-_002d-RDB-Mode-1"></a>
<h4 class="subsection">E.2.16 Smart Key - RDB Mode</h4>
<a name="index-rdb_002dmode"></a>
<a name="index-database"></a>
<div class="format">
<pre class="format">If pressed within an rdb-mode buffer which manipulates in-memory,
relational databases (part of InfoDock):
  ACTION KEY
    (1) on the name of a relation, the relation&rsquo;s full table is shown;
    (2) on an attribute name, all attribute columns aside from this one
        are removed from the relation display;
    (3) to the left of a tuple (row), the tuple is removed from the display;
    (4) on an attribute value, all tuples (rows) which do not contain
        the selected attribute value are removed from the current table display;
    (5) on or after the last line in the buffer, the current database is redisplayed;
    (6) anywhere else (except the end of a line), the last command is undone.&quot;
</pre></div>
<div class="format">
<pre class="format">  ASSIST KEY
    (1) on the name of a relation, the relation is removed from the display;
    (2) on an attribute name, the attribute column is removed from the relation
        display;
    (3) to the left of a tuple (row), the tuple is removed from the display;
    (4) on an attribute value, all tuples with the same attribute value are
        removed from the display.&quot;
</pre></div>

<hr>
<a name="Smart-Key-_002d-Help-Buffers"></a>
<div class="header">
<p>
Next: <a href="#Smart-Key-_002d-Bookmark-Mode" accesskey="n" rel="next">Smart Key - Bookmark Mode</a>, Previous: <a href="#Smart-Key-_002d-RDB-Mode" accesskey="p" rel="prev">Smart Key - RDB Mode</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart Keyboard Keys</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Smart-Key-_002d-Help-Buffers-1"></a>
<h4 class="subsection">E.2.17 Smart Key - Help Buffers</h4>
<a name="index-help-buffer"></a>
<div class="format">
<pre class="format">

When pressed at the end of a Help buffer:
  ACTION KEY or ASSIST KEY
    Restores the window configuration prior to the help display.
</pre></div>

<hr>
<a name="Smart-Key-_002d-Bookmark-Mode"></a>
<div class="header">
<p>
Next: <a href="#Smart-Key-_002d-Pages-Directory-Mode" accesskey="n" rel="next">Smart Key - Pages Directory Mode</a>, Previous: <a href="#Smart-Key-_002d-Help-Buffers" accesskey="p" rel="prev">Smart Key - Help Buffers</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart Keyboard Keys</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Smart-Key-_002d-Bookmark-Mode-1"></a>
<h4 class="subsection">E.2.18 Smart Key - Bookmark Mode</h4>

<div class="format">
<pre class="format">Bookmark-bmenu-mode lists existing per-user Emacs bookmarks, which each link to a particular file location.

When pressed on a bookmark-bmenu-mode entry line:
  ACTION KEY
     Jumps to the file point linked to by the bookmark.
  ASSIST KEY
     Shows what the Action Key does in this context.
</pre></div>

<hr>
<a name="Smart-Key-_002d-Pages-Directory-Mode"></a>
<div class="header">
<p>
Next: <a href="#Smart-Key-_002d-Python-Source-Code" accesskey="n" rel="next">Smart Key - Python Source Code</a>, Previous: <a href="#Smart-Key-_002d-Bookmark-Mode" accesskey="p" rel="prev">Smart Key - Bookmark Mode</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart Keyboard Keys</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Smart-Key-_002d-Pages-Directory-Mode-1"></a>
<h4 class="subsection">E.2.19 Smart Key - Pages Directory Mode</h4>

<div class="format">
<pre class="format">Pages-directory-mode is used in special buffers that contain title lines extracted from files consisting of titled, page-delimited contents, e.g. Info files.

When pressed on a pages-directory-mode entry line:
  ACTION KEY
     Jumps to the associated line in the pages file that contains the entry.
  ASSIST KEY
     Jumps to the associated line in the pages file that contains the entry.
</pre></div>

<hr>
<a name="Smart-Key-_002d-Python-Source-Code"></a>
<div class="header">
<p>
Next: <a href="#Smart-Key-_002d-Identifier-Menu-Mode" accesskey="n" rel="next">Smart Key - Identifier Menu Mode</a>, Previous: <a href="#Smart-Key-_002d-Pages-Directory-Mode" accesskey="p" rel="prev">Smart Key - Pages Directory Mode</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart Keyboard Keys</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Smart-Key-_002d-Python-Source-Code-1"></a>
<h4 class="subsection">E.2.20 Smart Key - Python Source Code</h4>
<div class="format">
<pre class="format">When the Jedi identifier server or the OO-Browser has been loaded and the press is
within a Python buffer:
  ACTION KEY or ASSIST KEY
     Jumps to the definition of the selected Python construct:
     (1) on an &lsquo;import&rsquo; line, the referent is displayed;
     (2) within a method declaration, its definition is displayed;
     (3) on a class name, the class definition is shown;
     (4) on a unique identifier reference, its definition is shown (when
         possible).
</pre></div>

<div class="format">
<pre class="format">When pressed within a Python source code file (without the OO-Browser):
  ACTION KEY
     Jumps to the definition of the selected Python identifier,
     assuming the identifier is found within an &quot;etags&quot; generated
     tags file within the current directory or any of its ancestor
     directories.
  ASSIST KEY
     Jumps to the next tag matching an identifier at point.
</pre></div>

<hr>
<a name="Smart-Key-_002d-Identifier-Menu-Mode"></a>
<div class="header">
<p>
Next: <a href="#Smart-Key-_002d-C-Source-Code" accesskey="n" rel="next">Smart Key - C Source Code</a>, Previous: <a href="#Smart-Key-_002d-Python-Source-Code" accesskey="p" rel="prev">Smart Key - Python Source Code</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart Keyboard Keys</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Smart-Key-_002d-Identifier-Menu-Mode-1"></a>
<h4 class="subsection">E.2.21 Smart Key - Identifier Menu Mode</h4>

<div class="format">
<pre class="format">This works only for identifiers defined within the same source file in
which they are referenced.  It requires either Emacs&rsquo; imenu library
and it requires that an index of identifiers has been built for the
current buffer.  Other handlers handle identifier references and
definitions across multiple files.

When pressed on an identifier name after an identifier index has been generated:
  ACTION KEY
     Jumps to the source definition within the current buffer of the identifier at point.
  ASSIST KEY
     Prompts with completion for an identifier defined within the buffer and then jumps
     to the its source definition.
</pre></div>

<hr>
<a name="Smart-Key-_002d-C-Source-Code"></a>
<div class="header">
<p>
Next: <a href="#Smart-Key-_002d-C_002b_002b-Source-Code" accesskey="n" rel="next">Smart Key - C++ Source Code</a>, Previous: <a href="#Smart-Key-_002d-Identifier-Menu-Mode" accesskey="p" rel="prev">Smart Key - Identifier Menu Mode</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart Keyboard Keys</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Smart-Key-_002d-C-Source-Code-1"></a>
<h4 class="subsection">E.2.22 Smart Key - C Source Code</h4>

<a name="index-smart_002dc_002dcpp_002dinclude_002dpath"></a>
<a name="index-smart_002dc_002dinclude_002dpath"></a>
<a name="index-smart_002dc_002duse_002dlib_002dman"></a>
<div class="format">
<pre class="format">When pressed within a C source code file:
  ACTION KEY
     Jumps to the definition of a selected C construct:
     (1) on a #include statement, the include file is displayed;
         this looks for include files using the directory lists
         &lsquo;smart-c-cpp-include-path&rsquo; and
         &lsquo;smart-c-include-path&rsquo;;
     (2) on a C identifier, the identifier definition is displayed,
         assuming the identifier is found within an &quot;etags&quot; generated
         tags file within the current directory or any of its ancestor
         directories;
     (3) if &lsquo;smart-c-use-lib-man&rsquo; is non-nil (see its documentation),
         the C identifier is recognized as a library symbol, and a man
         page is found for the identifier, then the man page is
         displayed.
  ASSIST KEY
     Jumps to the next tag matching an identifier at point.
</pre></div>

<hr>
<a name="Smart-Key-_002d-C_002b_002b-Source-Code"></a>
<div class="header">
<p>
Next: <a href="#Smart-Key-_002d-Assembly-Source-Code" accesskey="n" rel="next">Smart Key - Assembly Source Code</a>, Previous: <a href="#Smart-Key-_002d-C-Source-Code" accesskey="p" rel="prev">Smart Key - C Source Code</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart Keyboard Keys</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Smart-Key-_002d-C_002b_002b-Source-Code-1"></a>
<h4 class="subsection">E.2.23 Smart Key - C++ Source Code</h4>

<a name="index-c_002b_002b_002dcpp_002dinclude_002dpath"></a>
<a name="index-c_002b_002b_002dinclude_002dpath"></a>
<div class="format">
<pre class="format">When the OO-Browser has been loaded and the press is within a C++
buffer:
  ACTION KEY or ASSIST KEY
     Jumps to the definition of the selected C++ construct via
     OO-Browser support.
     (1) on a #include statement, the include file is displayed;
         this looks for include files using the directory lists
         &lsquo;smart-c-cpp-include-path&rsquo; and
         &lsquo;smart-c-include-path&rsquo;;
     (2) within a method definition before the opening brace, its
         declaration is displayed; 
     (3) within a method declaration, its definition is displayed;
     (4) on a class name, the class definition is shown;
     (5) on a member reference (past any :: scoping operator), the
         member definition or a listing of possible definitions or a
         matching declaration (if no definitions exist within the
         Environment) is shown;
     (6) on a global variable or function identifier, its definition is
         shown.
</pre></div>

<div class="format">
<pre class="format">When pressed within a C++ source code file (without the OO-Browser):
  ACTION KEY
     Jumps to the definition of the selected C++ construct:
     (1) on a #include statement, the include file is displayed;
         this looks for include files using the directory lists
         &lsquo;smart-c-cpp-include-path&rsquo; and
         &lsquo;smart-c-include-path&rsquo;;
     (2) on a C++ identifier, the identifier definition is displayed,
         assuming the identifier is found within an &quot;etags&quot; generated
         tags file in the current directory or any of its ancestor
         directories;
     (3) if &lsquo;smart-c-use-lib-man&rsquo; is non-nil (see its documentation),
         the C++ identifier is recognized as a library symbol, and a man
         page is found for the identifier, then the man page is
         displayed.
  ASSIST KEY
     Jumps to the next tag matching an identifier at point.
</pre></div>

<hr>
<a name="Smart-Key-_002d-Assembly-Source-Code"></a>
<div class="header">
<p>
Next: <a href="#Smart-Key-_002d-Lisp-Source-Code" accesskey="n" rel="next">Smart Key - Lisp Source Code</a>, Previous: <a href="#Smart-Key-_002d-C_002b_002b-Source-Code" accesskey="p" rel="prev">Smart Key - C++ Source Code</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart Keyboard Keys</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Smart-Key-_002d-Assembly-Source-Code-1"></a>
<h4 class="subsection">E.2.24 Smart Key - Assembly Source Code</h4>

<a name="index-smart_002dasm_002dinclude_002dpath"></a>
<div class="format">
<pre class="format">When pressed within an assembly source code file:
  ACTION KEY
     Jumps to the definition of the selected assembly construct:
     (1) on an include statement, the include file is displayed;
         this looks for include files using the directory list
         &lsquo;smart-asm-include-path&rsquo;;
     (2) on an identifier, the identifier definition is displayed,
         assuming the identifier is found within an &quot;etags&quot; generated
         tags file within the current directory or any of its ancestor
         directories.
  ASSIST KEY
     Jumps to the next tag matching an identifier at point.
</pre></div>

<hr>
<a name="Smart-Key-_002d-Lisp-Source-Code"></a>
<div class="header">
<p>
Next: <a href="#Smart-Key-_002d-Java-Source-Code" accesskey="n" rel="next">Smart Key - Java Source Code</a>, Previous: <a href="#Smart-Key-_002d-Assembly-Source-Code" accesskey="p" rel="prev">Smart Key - Assembly Source Code</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart Keyboard Keys</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Smart-Key-_002d-Lisp-Source-Code-1"></a>
<h4 class="subsection">E.2.25 Smart Key - Lisp Source Code</h4>

<div class="format">
<pre class="format"><a name="index-change_002dlog_002dmode"></a><a name="index-lisp-identifier"></a><a name="index-elisp-identifier"></a>When pressed on a Lisp symbol within any of these types of buffers
(Lisp code, debugger, compilation, or help) or in change-log-mode
on an Emacs Lisp bound identifier:
  ACTION KEY
     Jumps to the definition of any selected Lisp construct.  If on an
     Emacs Lisp require, load, or autoload clause and the (find-library)
     function is defined, jumps to the library source, if possible.
  ASSIST KEY
     Jumps to the next tag matching an identifier at point or if
     the identifier is an Emacs Lisp symbol, then this displays the
     documentation for the symbol.
</pre></div>

<hr>
<a name="Smart-Key-_002d-Java-Source-Code"></a>
<div class="header">
<p>
Next: <a href="#Smart-Key-_002d-JavaScript-Source-Code" accesskey="n" rel="next">Smart Key - JavaScript Source Code</a>, Previous: <a href="#Smart-Key-_002d-Lisp-Source-Code" accesskey="p" rel="prev">Smart Key - Lisp Source Code</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart Keyboard Keys</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Smart-Key-_002d-Java-Source-Code-1"></a>
<h4 class="subsection">E.2.26 Smart Key - Java Source Code</h4>

<a name="index-smart_002djava_002dpackage_002dpath"></a>
<div class="format">
<pre class="format">When the OO-Browser has been loaded and the press is within a Java
buffer:
  ACTION KEY or ASSIST KEY
     Jumps to the definition of the selected Java construct:
     (1) within a commented @see cross-reference, the referent is
         displayed;
     (2) on a package or import statement, the referent is
         displayed; this looks for referent files using the directory
         list &lsquo;smart-java-package-path&rsquo;;
     (3) within a method declaration, its definition is displayed;
     (4) on a class name, the class definition is shown;
     (5) on a unique identifier reference, its definition is shown (when
         possible).
</pre></div>

<div class="format">
<pre class="format">When pressed within a Java source code file (without the OO-Browser):
  ACTION KEY
     Jumps to the definition of the selected Java construct:
     (1) within a commented @see cross-reference, the referent is
         displayed;
     (2) on a package or import statement, the referent is
         displayed; this looks for referent files using the directory
         list &lsquo;smart-java-package-path&rsquo;;
     (3) on a Java identifier, the identifier definition is displayed,
         assuming the identifier is found within an &quot;etags&quot; generated
         tags file within the current directory or any of its ancestor
         directories.
  ASSIST KEY
     Jumps to the next tag matching an identifier at point.
</pre></div>

<hr>
<a name="Smart-Key-_002d-JavaScript-Source-Code"></a>
<div class="header">
<p>
Next: <a href="#Smart-Key-_002d-Objective_002dC-Source-Code" accesskey="n" rel="next">Smart Key - Objective-C Source Code</a>, Previous: <a href="#Smart-Key-_002d-Java-Source-Code" accesskey="p" rel="prev">Smart Key - Java Source Code</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart Keyboard Keys</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Smart-Key-_002d-JavaScript-Source-Code-1"></a>
<h4 class="subsection">E.2.27 Smart Key - JavaScript Source Code</h4>

<div class="format">
<pre class="format">When pressed within a JavaScript source code file:
  ACTION KEY
     Jumps to the definition of the selected JavaScript identifier,
     assuming the identifier is found within an &quot;etags&quot; generated
     tags file within the current directory or any of its ancestor
     directories.
  ASSIST KEY
     Jumps to the next tag matching an identifier at point.
</pre></div>


<hr>
<a name="Smart-Key-_002d-Objective_002dC-Source-Code"></a>
<div class="header">
<p>
Next: <a href="#Smart-Key-_002d-Fortran-Source-Code" accesskey="n" rel="next">Smart Key - Fortran Source Code</a>, Previous: <a href="#Smart-Key-_002d-JavaScript-Source-Code" accesskey="p" rel="prev">Smart Key - JavaScript Source Code</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart Keyboard Keys</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Smart-Key-_002d-Objective_002dC-Source-Code-1"></a>
<h4 class="subsection">E.2.28 Smart Key - Objective-C Source Code</h4>

<a name="index-objc_002dcpp_002dinclude_002dpath"></a>
<a name="index-objc_002dinclude_002dpath"></a>
<div class="format">
<pre class="format">When the OO-Browser has been loaded and the press is within a
Objective-C buffer:
  ACTION KEY or ASSIST KEY
     Jumps to the definition of the selected Objective-C construct via
     OO-Browser support.
     (1) on a #import or #include statement, the include file is
         displayed; this looks for include files using the directory
         lists &lsquo;objc-cpp-include-path&rsquo; and
         &lsquo;objc-include-path&rsquo;;
     (2) within a method declaration, its definition is displayed;
     (3) on a class name, the class definition is shown;
     (4) on a member reference (past any :: scoping operator), the
         member definition or a listing of possible definitions is
         shown;
     (5) on a global variable or function identifier, its definition
         is shown.
</pre></div>

<div class="format">
<pre class="format">When pressed within an Objective-C source code file (without the
OO-Browser):
  ACTION KEY
     Jumps to the definition of the selected Objective-C construct:
     (1) on a #import or #include statement, the include file is
         displayed; this looks for include files using the directory
         lists &lsquo;objc-cpp-include-path&rsquo; and
         &lsquo;objc-include-path&rsquo;;
     (2) on an Objective-C identifier, the identifier definition is
         displayed, assuming the identifier is found within an &quot;etags&quot;
         generated tags file in the current directory or any of its
         ancestor directories;
     (3) if &lsquo;smart-c-use-lib-man&rsquo; is non-nil (see its documentation),
         the Objective-C identifier is recognized as a library symbol,
         and a man page is found for the identifier, then the man page
         is displayed.
  ASSIST KEY
     Jumps to the next tag matching an identifier at point.
</pre></div>

<hr>
<a name="Smart-Key-_002d-Fortran-Source-Code"></a>
<div class="header">
<p>
Next: <a href="#Smart-Key-_002d-Occurrence-Matches" accesskey="n" rel="next">Smart Key - Occurrence Matches</a>, Previous: <a href="#Smart-Key-_002d-Objective_002dC-Source-Code" accesskey="p" rel="prev">Smart Key - Objective-C Source Code</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart Keyboard Keys</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Smart-Key-_002d-Fortran-Source-Code-1"></a>
<h4 class="subsection">E.2.29 Smart Key - Fortran Source Code</h4>

<div class="format">
<pre class="format">When pressed within a Fortran source code file:
  ACTION KEY or ASSIST KEY
     If on an identifier, the identifier definition (or a definition in
     which the identifier appears) is displayed, assuming the identifier
     is found within an &quot;etags&quot; generated tags file in the current
     directory or any of its ancestor directories.
</pre></div>

<hr>
<a name="Smart-Key-_002d-Occurrence-Matches"></a>
<div class="header">
<p>
Next: <a href="#Smart-Key-_002d-Calendar-Mode" accesskey="n" rel="next">Smart Key - Calendar Mode</a>, Previous: <a href="#Smart-Key-_002d-Fortran-Source-Code" accesskey="p" rel="prev">Smart Key - Fortran Source Code</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart Keyboard Keys</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Smart-Key-_002d-Occurrence-Matches-1"></a>
<h4 class="subsection">E.2.30 Smart Key - Occurrence Matches</h4>

<div class="format">
<pre class="format">When pressed within an occur-mode, moccur-mode or amoccur-mode buffer:
  ACTION KEY or ASSIST KEY
     Jumps to the source buffer and line of the current occurrence.
</pre></div>

<hr>
<a name="Smart-Key-_002d-Calendar-Mode"></a>
<div class="header">
<p>
Next: <a href="#Smart-Key-_002d-Man-Page-Apropos" accesskey="n" rel="next">Smart Key - Man Page Apropos</a>, Previous: <a href="#Smart-Key-_002d-Occurrence-Matches" accesskey="p" rel="prev">Smart Key - Occurrence Matches</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart Keyboard Keys</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Smart-Key-_002d-Calendar-Mode-1"></a>
<h4 class="subsection">E.2.31 Smart Key - Calendar Mode</h4>

<div class="format">
<pre class="format">When pressed within a calendar-mode buffer:
  ACTION KEY
     (1) at the end of the buffer, the calendar is scrolled forward 3
         months;
     (2) to the left of any dates on a calendar line, the calendar is
         scrolled backward 3 months;
     (3) on a date, the diary entries for the date, if any, are
         displayed.
  ASSIST KEY
     (1) at the end of the buffer, the calendar is scrolled backward 3
         months;
     (2) to the left of any dates on a calendar line, the calendar is
         scrolled forward 3 months;
     (3) anywhere else, all dates with marking diary entries are marked
         in the calendar window.
</pre></div>

<hr>
<a name="Smart-Key-_002d-Man-Page-Apropos"></a>
<div class="header">
<p>
Next: <a href="#Smart-Key-_002d-Emacs-Outline-Mode" accesskey="n" rel="next">Smart Key - Emacs Outline Mode</a>, Previous: <a href="#Smart-Key-_002d-Calendar-Mode" accesskey="p" rel="prev">Smart Key - Calendar Mode</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart Keyboard Keys</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Smart-Key-_002d-Man-Page-Apropos-1"></a>
<h4 class="subsection">E.2.32 Smart Key - Man Page Apropos</h4>
<div class="format">
<pre class="format">When pressed within a man page apropos buffer or listing:
  ACTION KEY
     (1) on a UNIX man apropos entry, the man page for that entry is
         displayed in another window;
     (2) on or after the last line, the buffer in the other window is
         scrolled up a windowful.
  ASSIST KEY
     (1) on a UNIX man apropos entry, the man page for that entry is
         displayed in another window;
     (2) on or after the last line, the buffer in the other window is
         scrolled down a windowful.
</pre></div>

<hr>
<a name="Smart-Key-_002d-Emacs-Outline-Mode"></a>
<div class="header">
<p>
Next: <a href="#Smart-Key-_002d-Info-Manuals" accesskey="n" rel="next">Smart Key - Info Manuals</a>, Previous: <a href="#Smart-Key-_002d-Man-Page-Apropos" accesskey="p" rel="prev">Smart Key - Man Page Apropos</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart Keyboard Keys</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Smart-Key-_002d-Emacs-Outline-Mode-1"></a>
<h4 class="subsection">E.2.33 Smart Key - Emacs Outline Mode</h4>
<a name="index-selective_002ddisplay"></a>
<a name="index-outline_002dmode"></a>
<a name="index-outline_002dminor_002dmode"></a>
<a name="index-outline_002dmode-1"></a>
<a name="index-outline_002dminor_002dmode-1"></a>
<div class="format">
<pre class="format">If pressed within an outline-mode buffer or when no other context is matched
and outline-minor-mode is enabled:
  ACTION KEY
     Collapses, expands, and moves outline entries.
     (1) after an outline heading has been cut via the Action Key,
         pastes the cut heading at point;
     (2) at the end of the buffer, shows all buffer text;
     (3) at the beginning of a heading line, cuts the headings subtree
         from the buffer;
     (4) on a header line but not at the beginning or end of the line,
         if the headings subtree is hidden, shows it, otherwise hides
         it;
     (5) anywhere else, invokes <code>action-key-eol-function</code>, typically
         to scroll up a windowful.
  ASSIST KEY
     (1) after an outline heading has been cut via the Action Key,
         allows multiple pastes throughout the buffer (the last paste
         should be done with the Action Key, not the Assist Key);
     (2) at the end of the buffer, hides all bodies in the buffer;
     (3) at the beginning of a heading line, cuts the current heading
         (sans subtree) from the buffer;
     (4) on a header line but not at the beginning or end, if the
         heading body is hidden, shows it, otherwise hides it;
     (5) anywhere else, invokes <code>assist-key-eol-function</code>, typically
         to scroll down a windowful.
</pre></div>

<hr>
<a name="Smart-Key-_002d-Info-Manuals"></a>
<div class="header">
<p>
Next: <a href="#Smart-Key-_002d-Email-Readers" accesskey="n" rel="next">Smart Key - Email Readers</a>, Previous: <a href="#Smart-Key-_002d-Emacs-Outline-Mode" accesskey="p" rel="prev">Smart Key - Emacs Outline Mode</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart Keyboard Keys</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Smart-Key-_002d-Info-Manuals-1"></a>
<h4 class="subsection">E.2.34 Smart Key - Info Manuals</h4>

<div class="format">
<pre class="format"><a name="index-click_002c-Info"></a><a name="index-Info-browsing"></a><a name="index-Info_002dglobal_002dnext"></a><a name="index-Info_002dglobal_002dprev"></a>If pressed within an Info manual node:
  ACTION KEY
     (1) on the first line of an Info Menu Entry or Cross Reference, the
         referenced node is displayed;
     (2) on the Up, Next, or Previous entries of a Node Header (first
         line), the referenced node is displayed;
     (3) on the File entry of a Node Header (first line), the Top node
         within that file is displayed;
     (4) at the end of the current node, the next node is displayed
         (this descends subtrees if the function (Info-global-next)
         is bound);
     (5) anywhere else (e.g. at the end of a line), the current node
         is scrolled up a windowful.
</pre></div>
<div class="format">
<pre class="format">  ASSIST KEY
     (1) on the first line of an Info Menu Entry or Cross Reference, the
         referenced node is displayed;
     (2) on the Up, Next, or Previous entries of a Node Header (first
         line), the last node in the history list is found;
     (3) on the File entry of a Node Header (first line), the DIR
         root-level node is found;
     (4) at the end of the current node, the previous node is displayed
         (this returns from subtrees if the function (Info-global-prev)
         is bound);
     (5) anywhere else (e.g. at the end of a line), the current node
         is scrolled down a windowful.

Use <kbd>{s}</kbd> within an Info manual to search for any concept that interests you.
</pre></div>

<hr>
<a name="Smart-Key-_002d-Email-Readers"></a>
<div class="header">
<p>
Next: <a href="#Smart-Key-_002d-GNUS-Newsreader" accesskey="n" rel="next">Smart Key - GNUS Newsreader</a>, Previous: <a href="#Smart-Key-_002d-Info-Manuals" accesskey="p" rel="prev">Smart Key - Info Manuals</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart Keyboard Keys</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Smart-Key-_002d-Email-Readers-1"></a>
<h4 class="subsection">E.2.35 Smart Key - Email Readers</h4>
<a name="index-hmail_003areader"></a>
<a name="index-hmail_003alister"></a>
<div class="format">
<pre class="format">If pressed within a Hyperbole-supported mail reader (defined by
&lsquo;hmail:reader&rsquo;) or a mail summary (defined by &lsquo;hmail:lister&rsquo;) buffer:
  ACTION KEY
     (1) in a msg buffer within the first line of a message or at the
         end of a message, the next undeleted message is displayed;
     (2) in a msg buffer within the first line of an Info cross
         reference, the referent is displayed;
     (3) anywhere else within a msg buffer, the window is scrolled up
         one windowful;
     (4) in a msg summary buffer on a header entry, the message
         corresponding to the header is displayed in the msg window;
     (5) in a msg summary buffer, on or after the last line, the
         messages marked for deletion are expunged.
</pre></div>
<div class="format">
<pre class="format">  ASSIST KEY
     (1) in a msg buffer within the first line or at the end of a
         message, the previous undeleted message is displayed;
     (2) in a msg buffer within the first line of an Info cross
         reference, the referent is displayed;
     (3) anywhere else within a msg buffer, the window is scrolled down
         one windowful;
     (4) in a msg summary buffer on a header entry, the message
         corresponding to the header is marked for deletion;
     (5) in a msg summary buffer on or after the last line, all messages
         are marked undeleted.
</pre></div>

<hr>
<a name="Smart-Key-_002d-GNUS-Newsreader"></a>
<div class="header">
<p>
Next: <a href="#Smart-Key-_002d-Buffer-Menus" accesskey="n" rel="next">Smart Key - Buffer Menus</a>, Previous: <a href="#Smart-Key-_002d-Email-Readers" accesskey="p" rel="prev">Smart Key - Email Readers</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart Keyboard Keys</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Smart-Key-_002d-GNUS-Newsreader-1"></a>
<h4 class="subsection">E.2.36 Smart Key - GNUS Newsreader</h4>
<a name="index-click_002c-Gnus"></a>
<a name="index-Gnus-browsing"></a>
<div class="format">
<pre class="format">If pressed within the Gnus newsgroups listing buffer:
  ACTION KEY
     (1) on a GNUS-GROUP line, that newsgroup is read;
     (2) if &lsquo;gnus-topic-mode&rsquo; is active, and on a topic line, the topic is
         expanded or collapsed as needed;
     (3) to the left of any GNUS-GROUP line, within any of the
         whitespace, the current group is unsubscribed or resubscribed;
     (4) at the end of the GNUS-GROUP buffer after all lines, the
         number of waiting messages per group is updated.
</pre></div>
<div class="format">
<pre class="format">  ASSIST KEY
     (1) on a GNUS-GROUP line, that newsgroup is read;
     (2) if &lsquo;gnus-topic-mode&rsquo; is active, and on a topic line, the topic is
         expanded or collapsed as needed;
     (3) to the left of any GNUS-GROUP line, within any of the
         whitespace, the user is prompted for a group name to subscribe
         or unsubscribe to;
     (4) at the end of the GNUS-GROUP buffer after all lines, the
         newsreader is quit.
</pre></div>

<div class="format">
<pre class="format">If pressed within a Gnus newsreader subject listing buffer:
  ACTION KEY
     (1) on a GNUS-SUBJECT line, that article is read, marked deleted,
         and scrolled forward;
     (2) at the end of the GNUS-SUBJECT buffer, the next undeleted
         article is read or the next group is entered.
</pre></div>
<div class="format">
<pre class="format">  ASSIST KEY
     (1) on a GNUS-SUBJECT line, that article is read and scrolled
         backward;
     (2) at the end of the GNUS-SUBJECT buffer, the group is exited and
         the user is returned to the group listing buffer.
</pre></div>

<div class="format">
<pre class="format">If pressed within a Gnus newsreader article buffer:
  ACTION KEY
     (1) on the first line or at the end of an article, the next unread
         message is displayed;
     (2) on the first line of an Info cross reference, the referent is
         displayed;
     (3) anywhere else, the window is scrolled up a windowful.
</pre></div>
<div class="format">
<pre class="format">  ASSIST KEY
     (1) on the first line or end of an article, the previous message is
         displayed;
     (2) on the first line of an Info cross reference, the referent is
         displayed;
     (3) anywhere else, the window is scrolled down a windowful.
</pre></div>

<hr>
<a name="Smart-Key-_002d-Buffer-Menus"></a>
<div class="header">
<p>
Next: <a href="#Smart-Key-_002d-Tar-File-Mode" accesskey="n" rel="next">Smart Key - Tar File Mode</a>, Previous: <a href="#Smart-Key-_002d-GNUS-Newsreader" accesskey="p" rel="prev">Smart Key - GNUS Newsreader</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart Keyboard Keys</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Smart-Key-_002d-Buffer-Menus-1"></a>
<h4 class="subsection">E.2.37 Smart Key - Buffer Menus</h4>
<a name="index-click_002c-buffer-menu"></a>
<a name="index-buffer-menu-2"></a>
<div class="format">
<pre class="format">If pressed within a listing of buffers (Buffer-menu-mode):
  ACTION KEY
     (1) on the first column of an entry, the selected buffer is marked
         for display;
     (2) on the second column of an entry, the selected buffer is marked
         for saving;
     (3) anywhere else within an entry line, all saves and deletes are
         done, and selected buffers are displayed, including the one
         just clicked on (if in the OO-Browser, only the selected buffer
         is displayed);
     (4) on or after the last line in the buffer, all saves and deletes
         are done.
</pre></div>
<div class="format">
<pre class="format">  ASSIST KEY
     (1) on the first or second column of an entry, the selected buffer
         is unmarked for display and for saving or deletion;
     (2) anywhere else within an entry line, the selected buffer is
         marked for deletion;
     (3) on or after the last line in the buffer, all display, save, and
         delete marks on all entries are undone.
</pre></div>

<a name="index-click_002c-ibuffer-menu"></a>
<a name="index-ibuffer-menu-1"></a>
<div class="format">
<pre class="format">If pressed within an interactive buffer menu (ibuffer-mode):
  ACTION KEY
     (1) on the first or second column of an entry, the selected buffer is
         marked for display;
     (2) anywhere else within an entry line, all saves and deletes are done, and
         selected buffers are displayed, including the one just clicked on (if
         within the OO-Browser user interface, only the selected buffer is
         displayed);
     (3) on the first or last line in the buffer, all deletes are done.
</pre></div>
<div class="format">
<pre class="format">  ASSIST KEY
     (1) on the first or second column of an entry, the selected buffer is unmarked
         for display or deletion; 
     (2) anywhere else within an entry line, the selected buffer is marked for
         deletion;
     (3) on the first or last line in the buffer, all display, save, and delete
         marks on all entries are undone.
</pre></div>

<hr>
<a name="Smart-Key-_002d-Tar-File-Mode"></a>
<div class="header">
<p>
Next: <a href="#Smart-Key-_002d-Man-Pages" accesskey="n" rel="next">Smart Key - Man Pages</a>, Previous: <a href="#Smart-Key-_002d-Buffer-Menus" accesskey="p" rel="prev">Smart Key - Buffer Menus</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart Keyboard Keys</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Smart-Key-_002d-Tar-File-Mode-1"></a>
<h4 class="subsection">E.2.38 Smart Key - Tar File Mode</h4>
<a name="index-click_002c-tar"></a>
<a name="index-tar-archive-browsing"></a>
<a name="index-extracting-from-tar-files"></a>
<div class="format">
<pre class="format">If pressed within a tar-mode buffer:
  ACTION KEY
     (1) on an entry line, the selected file/directory is displayed for
         editing in the other window;
     (2) on or after the last line in the buffer, if any deletes are to
         be performed, they are executed after user verification;
         otherwise, this tar file browser is quit.
</pre></div>
<div class="format">
<pre class="format">  ASSIST KEY
     (1) on an entry line, the current entry is marked for deletion;
     (2) on or after the last line in the buffer, all delete marks on
         all entries are undone.
</pre></div>

<hr>
<a name="Smart-Key-_002d-Man-Pages"></a>
<div class="header">
<p>
Next: <a href="#Smart-Key-_002d-WWW-URLs" accesskey="n" rel="next">Smart Key - WWW URLs</a>, Previous: <a href="#Smart-Key-_002d-Tar-File-Mode" accesskey="p" rel="prev">Smart Key - Tar File Mode</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart Keyboard Keys</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Smart-Key-_002d-Man-Pages-1"></a>
<h4 class="subsection">E.2.39 Smart Key - Man Pages</h4>
<a name="index-man-page-references"></a>
<a name="index-smart_002dman_002dc_002droutine_002dref"></a>
<div class="format">
<pre class="format">If pressed on a cross reference within a man page entry section labeled
NAME, SEE ALSO, or PACKAGES USED, or within a man page C routine
specification (see &lsquo;smart-man-c-routine-ref&rsquo;) and the man page buffer
has either an attached file or else a man-path local variable
containing its pathname:
  ACTION KEY or ASSIST KEY
     Displays the man page or source code for the cross reference.
</pre></div>

<hr>
<a name="Smart-Key-_002d-WWW-URLs"></a>
<div class="header">
<p>
Next: <a href="#Smart-Key-_002d-HyRolo-Match-Buffers" accesskey="n" rel="next">Smart Key - HyRolo Match Buffers</a>, Previous: <a href="#Smart-Key-_002d-Man-Pages" accesskey="p" rel="prev">Smart Key - Man Pages</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart Keyboard Keys</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Smart-Key-_002d-WWW-URLs-1"></a>
<h4 class="subsection">E.2.40 Smart Key - WWW URLs</h4>
<a name="index-click_002c-world_002dwide-web"></a>
<a name="index-W3"></a>
<a name="index-URL-2"></a>
<a name="index-browse_002durl_002dbrowser_002dfunction-2"></a>
<a name="index-World_002dwide-Web-2"></a>
<a name="index-WWW-2"></a>
<a name="index-C_002dh-h-c-u-1"></a>
<a name="index-menu_002c-Cust_002fURL_002dDisplay-1"></a>
<div class="format">
<pre class="format">If pressed on a World-Wide Web universal resource locator (URL):
  ACTION KEY
     Displays the referent for the URL at point using the web browser
     given by the variable, <code>browse-url-browser-function</code>.  Adjust
     this setting with the Cust/URL-Display <kbd>{C-h h c u}</kbd> menu.
  ASSIST KEY
     Displays help for the ACTION KEY.
</pre></div>

<hr>
<a name="Smart-Key-_002d-HyRolo-Match-Buffers"></a>
<div class="header">
<p>
Next: <a href="#Smart-Key-_002d-Image-Thumbnails" accesskey="n" rel="next">Smart Key - Image Thumbnails</a>, Previous: <a href="#Smart-Key-_002d-WWW-URLs" accesskey="p" rel="prev">Smart Key - WWW URLs</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart Keyboard Keys</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Smart-Key-_002d-HyRolo-Match-Buffers-1"></a>
<h4 class="subsection">E.2.41 Smart Key - HyRolo Match Buffers</h4>
<a name="index-click_002c-hyrolo-matches"></a>
<a name="index-hyrolo-matches"></a>
<div class="format">
<pre class="format">If pressed within an entry in the HyRolo search results buffer:
  ACTION KEY or ASSIST KEY
     The entry is edited in the other window.
</pre></div>

<hr>
<a name="Smart-Key-_002d-Image-Thumbnails"></a>
<div class="header">
<p>
Next: <a href="#Smart-Key-_002d-Gomoku-Game" accesskey="n" rel="next">Smart Key - Gomoku Game</a>, Previous: <a href="#Smart-Key-_002d-HyRolo-Match-Buffers" accesskey="p" rel="prev">Smart Key - HyRolo Match Buffers</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart Keyboard Keys</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Smart-Key-_002d-Image-Thumbnails-1"></a>
<h4 class="subsection">E.2.42 Smart Key - Image Thumbnails</h4>
<a name="index-images"></a>
<a name="index-thumbnails"></a>
<a name="index-dired_002c-images"></a>
<a name="index-image_002ddired_002dexternal_002dviewer"></a>
<div class="format">
<pre class="format">If pressed within a Dired Image Thumbnail buffer:
  ACTION KEY
     Selects the chosen thumbnail and scales its image for display in another Emacs window.
  ASSIST KEY
     Selects thumbnail and uses the external viewer named by <code>image-dired-external-viewer</code>
     to display it.
</pre></div>

<hr>
<a name="Smart-Key-_002d-Gomoku-Game"></a>
<div class="header">
<p>
Next: <a href="#Smart-Key-_002d-Magit-Mode" accesskey="n" rel="next">Smart Key - Magit Mode</a>, Previous: <a href="#Smart-Key-_002d-Image-Thumbnails" accesskey="p" rel="prev">Smart Key - Image Thumbnails</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart Keyboard Keys</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Smart-Key-_002d-Gomoku-Game-1"></a>
<h4 class="subsection">E.2.43 Smart Key - Gomoku Game</h4>
<a name="index-game_002c-gomoku"></a>
<a name="index-gomoku"></a>
<div class="format">
<pre class="format">If pressed within a Gomoku game buffer:
  ACTION KEY
     Makes a move to the selected space.
  ASSIST KEY
     Takes back a prior move made at the selected space.
</pre></div>

<hr>
<a name="Smart-Key-_002d-Magit-Mode"></a>
<div class="header">
<p>
Next: <a href="#Smart-Key-_002d-The-OO_002dBrowser" accesskey="n" rel="next">Smart Key - The OO-Browser</a>, Previous: <a href="#Smart-Key-_002d-Gomoku-Game" accesskey="p" rel="prev">Smart Key - Gomoku Game</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart Keyboard Keys</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Smart-Key-_002d-Magit-Mode-1"></a>
<h4 class="subsection">E.2.44 Smart Key - Magit Mode</h4>
<a name="index-git"></a>
<a name="index-magit"></a>
<div class="format">
<pre class="format">If pressed within a Magit buffer and not on a button:
  ACTION KEY
     (1) on the last line, quit from the magit mode (<kbd>{q}</kbd> key binding);
     (2) at the end of a line, scroll up a windowful;
     (3) on an initial read-only header line, cycle visibility of diff sections;
     (4) anywhere else, hide/show the thing at point (<kbd>{<span class="key">TAB</span>}</kbd> key binding)
         unless that does nothing in the mode, then jump to the thing at point
         (<kbd>{<span class="key">RET</span>}</kbd> key binding).
  ASSIST KEY
     (1) on the last line, quit from the magit mode (<kbd>{q}</kbd> key binding);
     (2) at the end of a line, scroll down a windowful;
     (3) on an initial read-only header line, cycle visibility of all sections;
     (4) anywhere else, jump to the thing at point (<kbd>{<span class="key">RET</span>}</kbd> key binding).&quot;
</pre></div>

<hr>
<a name="Smart-Key-_002d-The-OO_002dBrowser"></a>
<div class="header">
<p>
Next: <a href="#Smart-Key-_002d-Default-Context" accesskey="n" rel="next">Smart Key - Default Context</a>, Previous: <a href="#Smart-Key-_002d-Magit-Mode" accesskey="p" rel="prev">Smart Key - Magit Mode</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart Keyboard Keys</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Smart-Key-_002d-The-OO_002dBrowser-1"></a>
<h4 class="subsection">E.2.45 Smart Key - The OO-Browser</h4>

<a name="index-OO_002dBrowser"></a>
<a name="index-object_002doriented-code-browsing"></a>
<div class="format">
<pre class="format">If pressed within an OO-Browser implementors, elements or OOBR-FTR tags
buffer after an OO-Browser Environment has been loaded:
  ACTION KEY
     Jumps to the definition of the item at point.
  ASSIST KEY
     Displays help for the Action Key context at point.
</pre></div>

<div class="format">
<pre class="format">When pressed within an OO-Browser listing window:
  ACTION KEY
     (1) in a blank buffer or at the end of a buffer, browser help
         information is displayed in the viewer window;
     (2) on a default class name, the statically defined instances of
         the default class are listed;
     (3) at the beginning of a (non-single char) class name, the class&rsquo;
         ancestors are listed;
     (4) at the end of an entry line, the listing is scrolled up;
     (5) on the &lsquo;...&rsquo;, following a class name, point is moved to the
         class descendency expansion;
     (6) before an element entry, the element&rsquo;s implementors are
         listed;
     (7) anywhere else on an entry line, the source is displayed for
         editing.
</pre></div>

<div class="format">
<pre class="format">  ASSIST KEY
     (1) in a blank buffer, a selection list of buffer files is
         displayed;
     (2) on a default class name, the statically defined instances of
         the default class are listed;
     (3) at the beginning of a (non-single char) entry, the class&rsquo;
         descendants are listed;
     (4) at the end of an entry line, the listing is scrolled down;
     (5) on the &lsquo;...&rsquo;, following a class name, point is moved to the
         class expansion;
     (6) anywhere else on a class entry line, the class&rsquo; elements are
         listed;
     (7) anywhere else on an element line, the element&rsquo;s implementors
         are listed;
     (8) on a blank line following all entries, the current listing
         buffer is exited.
</pre></div>

<div class="format">
<pre class="format">When pressed within the OO-Browser Command Help Menu Buffer:
  ACTION KEY
     Executes an OO-Browser command whose key binding is at point.
  ASSIST KEY
     Displays help for an OO-Browser command whose key binding is at
     point.
</pre></div>

<div class="format">
<pre class="format">When pressed on an identifier within an OO-Browser source file:
  ACTION KEY
     Tries to display the identifier definition.
  ASSIST KEY
     Does nothing.
</pre></div>

<hr>
<a name="Smart-Key-_002d-Default-Context"></a>
<div class="header">
<p>
Previous: <a href="#Smart-Key-_002d-The-OO_002dBrowser" accesskey="p" rel="prev">Smart Key - The OO-Browser</a>, Up: <a href="#Smart-Keyboard-Keys" accesskey="u" rel="up">Smart Keyboard Keys</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Smart-Key-_002d-Default-Context-1"></a>
<h4 class="subsection">E.2.46 Smart Key - Default Context</h4>
<a name="index-action_002dkey_002ddefault_002dfunction-1"></a>
<a name="index-assist_002dkey_002ddefault_002dfunction-1"></a>
<a name="index-hyperbole-1"></a>
<a name="index-hyperbole_002dpopup_002dmenu-1"></a>
<a name="index-hkey_002dsummarize"></a>
<a name="index-Smart-Key_002c-default-context-1"></a>
<div class="format">
<pre class="format">Finally, if pressed within an unrecognized context:
  ACTION KEY
     Runs the function stored in <code>action-key-default-function</code>.
     By default, it just displays an error message.  Set it to
     <code>hyperbole</code> if you want it to display the Hyperbole
     minibuffer menu or <code>hyperbole-popup-menu</code> to popup the
     Hyperbole menubar menu.
  ASSIST KEY
     Runs the function stored in <code>assist-key-default-function</code>.
     By default, it just displays an error message.  Set it to
     <code>hkey-summarize</code> if you want it to display a summary of
     Smart Key behavior.
</pre></div>


<hr>
<a name="Suggestion-or-Bug-Reporting"></a>
<div class="header">
<p>
Next: <a href="#Questions-and-Answers" accesskey="n" rel="next">Questions and Answers</a>, Previous: <a href="#Smart-Key-Reference" accesskey="p" rel="prev">Smart Key Reference</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Suggestion-or-Bug-Reporting-1"></a>
<h2 class="appendix">Appendix F Suggestion or Bug Reporting</h2>

<a name="index-version-description"></a>
<a name="index-Hyperbole-version"></a>
<p>If you find any errors in Hyperbole&rsquo;s operation or documentation, feel
free to report them to &lt;bug-hyperbole@gnu.org&gt;.  Be sure to use the
<kbd>{C-h h m r}</kbd> Msg/Report-Hypb-Bug minibuffer menu item whenever you send a message
to this address since that command will insert important system
version information for you.
</p>
<p>If you use Hyperbole mail or news support (see <a href="#Buttons-in-Mail">Buttons in Mail</a>), a
press of your Action Key on the Hyperbole mail list address will
insert a description of your Hyperbole configuration information into
your outgoing message, so that you do not have to type it.  Otherwise,
be sure to include the version numbers of your editor, Hyperbole and
your window system.  Your Hyperbole version number can be found in the
top-level Hyperbole menu.
</p>
<p>Below are some tips on how best to structure requests and discussion
messages.  If you share information about your use of Hyperbole with
others, it will promote broader use and development of Hyperbole.
</p>
<ul>
<li> Always use your Subject lines to state the position that your message
takes on the topic that it addresses.

<div class="display">
<pre class="display">For example, write: &ldquo;Subject: Typo in top-level Hyperbole minibuffer menu.&rdquo;

rather than: &ldquo;Subject: Hyperbole bug&rdquo;
</pre></div>

</li><li> Statements end with periods, questions with question marks (typically),
and high energy, high impact declarations with exclamation points.  These
simple rules make all e-mail communication much easier for recipients to
handle appropriately.

</li><li> <a name="index-emacs_002dversion"></a>
Question messages should normally include your Hyperbole and Emacs
version numbers and should clearly explain your problem and surrounding
issues.  Otherwise, it is difficult for anyone to answer your question.
(Your top-level Hyperbole menu shows its version number and <kbd>{M-x
emacs-version <span class="key">RET</span>}</kbd> gives the other.)

</li><li> If you ask questions, you should consider adding to the discussion by
telling people the kinds of work you are doing or contemplating doing
with Hyperbole.  In this way, the list is not overrun by messages that
ask for, but provide no information.
</li></ul>

<p>If you have suggestions on how to improve Hyperbole, send them to
&lt;hyperbole-users@gnu.com&gt; (<kbd>{C-h h m c}</kbd> minibuffer menu item
Msg/Compose-Hypb-Mail).  Here are some issues you might address:
</p>
<ul>
<li> What did you like and dislike about the system?
</li><li> What kinds of tasks, if any, does it seem to help you with?
</li><li> What did you think of the Emacs-based user interface?
</li><li> How was the Hyperbole Manual and other documentation?
</li><li> Was the setup trivial, average or hard?
</li><li> What areas of Hyperbole would you like to see expanded/added?
</li><li> How does it compare to other hypertext tools you have used?
</li><li> Was it easy or difficult to create your own types?  Why?
</li><li> Did you get any use out of the external system encapsulations?
</li></ul>

<hr>
<a name="Questions-and-Answers"></a>
<div class="header">
<p>
Next: <a href="#Future-Work" accesskey="n" rel="next">Future Work</a>, Previous: <a href="#Suggestion-or-Bug-Reporting" accesskey="p" rel="prev">Suggestion or Bug Reporting</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Questions-and-Answers-1"></a>
<h2 class="appendix">Appendix G Questions and Answers</h2>

<ol>
<li> As I discover the Zen of Hyperbole, will I become so enamored of its power that I lose all control of my physical faculties?

<p>This other-worldly reaction is of course an individual matter.  Some
people have canceled meditation trips to the Far East after
discovering that pressing the Action Key in random contexts serves a
similar purpose much more cheaply.  We have not seen anyone&rsquo;s mind
turn to jelly but with the cognition Hyperbole saves you, you might
just grow a second one.  Eventually, you will be at peace and will
understand that there is no adequate description of Hyperbole.  Just
let it flow through you.
</p>
<p>Ok, joking aside, now that we have your attention, here are some
serious questions and answers.
</p>
</li><li> <a name="index-Org_002dmode-1"></a>
Isn&rsquo;t Org-mode the same as Hyperbole?

<p>No, they offer very different capabilities when you compare them a bit
more deeply.  In fact, it makes sense to use them together and they
are highly compatible.  The only overlap we see is that Org-mode has a
more limited kind of hyperlinks and offers some BBDB integration as
Hyperbole does.  For a list of some differences, see:
<a href="https://www.emacswiki.org/emacs/Hyperbole">https://www.emacswiki.org/emacs/Hyperbole</a>.
</p>
<a name="index-inhibit_002dhsys_002dorg-1"></a>
<p>Smart Key support for Org-mode is already in Hyperbole with compatibility
with Org&rsquo;s <kbd>{M-RET}</kbd> binding.  With the flag, <code>inhibit-hsys-org</code>
set to <code>t</code>, Hyperbole gives Org complete control over that key as well.
</p>
<p>Org-mode offers traditional Emacs outlining, todo list management,
agenda and diary management, so it is very complementary to Hyperbole.
It did not exist when Hyperbole was first developed.
</p>
</li><li> <a name="index-Smart-Key-2"></a>
<a name="index-mouse-key-bindings"></a>
<a name="index-hmouse_002dsetup"></a>
<a name="index-hmouse_002dget_002dbindings"></a>
<a name="index-file_002c-hmouse_002dsh_002eel"></a>
How can I change the Smart Mouse Key bindings?

<a name="index-hmouse_002dsetup-1"></a>
<a name="index-hmouse_002dget_002dbindings-1"></a>
<p>Since the Smart Mouse Keys are set up for use under many different
Emacs configurations, there is no easy way to provide user level
customization.  Any mouse key binding changes require editing the
<code>(hmouse-setup)</code> and <code>(hmouse-get-bindings)</code> functions in the
<samp>hmouse-sh.el</samp> file.
</p>
<a name="index-file_002c-hmouse_002dkey_002eel"></a>
<a name="index-file_002c-hui_002dwindow_002eel"></a>
<a name="index-hkey_002dalist"></a>
<a name="index-hmouse_002dalist"></a>
<p>To make the Smart Keys do new things in particular contexts, define new
types of implicit buttons, see <a href="#Implicit-Buttons">Implicit Buttons</a>.
</p>
<p>The <code>hkey-alist</code> and <code>hmouse-alist</code> variables in
<samp>hui-mouse.el</samp> and <samp>hui-window.el</samp> must be altered if you want
to change what the Smart Keys do in standard contexts.  You should
then update the Smart Key summary documentation in the file,
<samp>man/hkey-help.txt</samp>, and then regenerate the readable forms of
this manual which includes that file.
</p>
</li><li> What if I get mail with a Hyperbole button type I don&rsquo;t have?

<p>Or what if someone sends a mail message with a button whose link
referent I can&rsquo;t access?
</p>
<p>You receive an error that an action type is not defined or a link
referent is not accessible/readable if you try to use the button.  This
is hardly different than trying to get through a locked door without a
key; you try the doorknob, find that it is locked, and then realize that
you need to take a different approach or else give up.
</p>
<p>Like all communication, people need to coordinate, which usually
requires an iterative process.  If you get a mail message with a button
for which you don&rsquo;t have the action type, you mail the sender and
request it.
</p>
</li><li> <a name="index-global-button_002c-modify"></a>
How can I modify a number of global buttons in succession?

<p>Rather than typing the name for each, it is quicker to jump to the
global button file and edit the buttons there as you would any
explicit or implicit buttons.  By default, the ButFile/PersonalFile
menu item takes you to the file where global buttons are saved.
Global buttons are saved near the end of this file.
</p>
</li><li> Why are button attributes scattered across directories?

<p>When you think of a hyperspace that you depend on every day, you
don&rsquo;t want to have a single point of failure that can make you
incapable of doing work.  With Hyperbole, if some directories become
unavailable for a particular time (e.g. the filesystems on which
they reside are dismounted) you can still work elsewhere with minimal
effect.  We believe this to be a compelling factor to leave the design
with distributed button attribute storage.
</p>
<p>This design also permits the potential addition of buttons to read-only
media.
</p>
</li><li> Why are action types defined apart from implicit button types?

<p>Any category of button can make use of an action type.  Some action
types are useful as behavior definitions for a variety of button
categories, so all action types are defined separately to give them
independence from those types which apply them.
</p>
<p>For implicit button types that require a lot of code, it is useful to
add a module that includes the implicit button type definition, its
action type definition and supporting code.  Then simply load that
module into your Emacs session.
</p>
</li></ol>


<hr>
<a name="Future-Work"></a>
<div class="header">
<p>
Next: <a href="#References" accesskey="n" rel="next">References</a>, Previous: <a href="#Questions-and-Answers" accesskey="p" rel="prev">Questions and Answers</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Future-Work-1"></a>
<h2 class="appendix">Appendix H Future Work</h2>

<p>This appendix is included for a number of reasons:
</p>
<ul>
<li> to better allow you to assess whether to work with Hyperbole by
providing sketches of possible additions;
</li><li> to direct further development effort towards known needs;
</li><li> and to acknowledge known weaknesses in the current system.
</li></ul>

<p>Without any serious interest from users, progress on these fronts will
be slow.  Here are some new features we have in mind, however.
</p>
<dl compact="compact">
<dt>Button Copying, Killing, and Yanking</dt>
<dd><p>There is as yet no means of transferring explicit buttons among
buffers. We realize this is an important need.  Users should be able to
manipulate text with embedded buttons in ordinary ways.  With this
feature, Hyperbole would store the button attributes as text
properties within the buffers so that if a button is copied, its
attributes follow.  When a buffer is saved, the attributes also will
be saved.
</p>
</dd>
<dt>Koutliner View Mode</dt>
<dd><p>This will complement the Koutliner editing mode by using simple one
character keys that normally insert characters to instead modify the
view of a Koutline and to move around in it, for ease of study.
Switching between view and edit modes will also be simple.
</p>
</dd>
<dt>Direct Manipulation</dt>
<dd><p>Hyperbole is designed to let you rapidly navigate and manipulate
large, distributed information spaces.  Being able to directly
manipulate entities in these spaces will accelerate understanding and
production of new information.  Already Hyperbole lets you drag
buffers, windows, files, and directories and place them where you
like.  But there is much more that can be done to allow for
higher-level browsing and information organization.
</p>
</dd>
<dt>Trails</dt>
<dd><p>Trails are an extension to the basic history mechanism presently offered
by Hyperbole.  Trails will allow a user to capture, edit and store a
specific sequence and set of views of information for later replay by
other users.  Conditional branching may also be supported.
</p>
</dd>
<dt>Storage of button data within button source files</dt>
<dd><p>The current design choice of storing buttons external to the source file
was made under the assumption that people should be able to look at
files that contain Hyperbole buttons with any standard editor or tool
and not be bothered by the ugly button data (since they won&rsquo;t be able to
utilize the buttons anyway, they don&rsquo;t need to see or have access to
them).
</p>
<p>In many contexts, embedding the button data within the source files may
be a better choice, so a provision which would allow selection of either
configuration may be added.  Here are some of the PROs and CONs of both
design choices:
</p><br>
</dd>
</dl>

<div class="example">
<pre class="example">           POSITIVE                        NEGATIVE

Button data in source file
           Documents can stand alone.      All edit operators have
           Normal file operations apply.   to account for file
                                           structure and hide
           Simplifies creation and         internal components.
           facility expansion for
           structured and multimedia
           files.

Button data external to source file
           Files can be displayed and      Currently, attributes for
           printed exactly as they look.   a whole directory are
           No special display formatting   locked when any button
           is necessary.                   entry is locked.

           Button-based searches and
           database-type lookup operations
           need only search one file
           per directory.
</pre></div>
<br>
<br>

<dl compact="compact">
<dt>Forms-based Interfaces</dt>
<dd>
<p>This will allow one to create buttons more flexibly.  For example, button
attributes could be given in any order.  Entry of long code sequences,
quick note taking and cross-referencing would also be made easier.
</p>
</dd>
<dt>Collaboration Support</dt>
<dd>
<p>From the early stages of Hyperbole design, collaborative work
environments have been considered.  A simple facility has demonstrated
broadcast of button activations to a number of workstations on a local
area network, so that one user can lead others around an information
space, as during an online design review.  (This facility was never
adapted to the current Hyperbole release, however).  Nowadays you
could just use a screen sharing program.
</p>
</dd>
</dl>

<hr>
<a name="References"></a>
<div class="header">
<p>
Next: <a href="#Key-Index" accesskey="n" rel="next">Key Index</a>, Previous: <a href="#Future-Work" accesskey="p" rel="prev">Future Work</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="References-1"></a>
<h2 class="appendix">Appendix I References</h2>

<dl compact="compact">
<dt><b>[AkMcYo88]</b></dt>
<dd><p>Akscyn, R. M., D. L. McCracken and E. A. Yoder. KMS: A
Distributed Hypermedia System for Managing Knowledge in Organizations.
<em>Communications of the ACM</em>, Vol. 31, No. 7, July 1988, pp. 820-835.
</p>
</dd>
<dt><b>[Bro87]</b></dt>
<dd><p>Brown, P. J. Turning Ideas into Products: The Guide System.
<em>Proceedings of Hypertext &rsquo;87</em>, November 13-15, 1987, Chapel Hill, NC.
ACM: NY, NY, pp. 33-40.
</p>
</dd>
<dt><b>[Con87]</b></dt>
<dd><p>Conklin, Jeff. Hypertext: An Introduction and Survey. <em>IEEE
Computer</em>, Vol. 20, No. 9, September 1987, pp. 17-41.
</p>
</dd>
<dt><b>[Eng68]</b></dt>
<dd><p>Engelbart, D., and W. English.  A research center for augmenting
human intellect. <em>Proceedings of the Fall Joint Computer Conference</em>,
33, 1, AFIPS Press: Montvale, NJ, 1968, pp. 395-410.
</p>
</dd>
<dt><b>[Eng84a]</b></dt>
<dd><p>Engelbart, D. C. Authorship Provisions in Augment.
<em>Proceedings of the 1984 COMPCON Conference (COMPCON &rsquo;84 Digest)</em>,
February 27-March 1, 1984, San Francisco, CA. IEEE Computer Society Press,
Spring, 1984.  465-472. (OAD,2250,)
</p>
</dd>
<dt><b>[Eng84b]</b></dt>
<dd><p>Engelbart, D. C. Collaboration Support Provisions in Augment.
<em>Proceedings of the AFIPS Office Automation Conference (OAC &rsquo;84 Digest)</em>,
February, 1984, Los Angeles, CA, 1984. 51-58. (OAD,2221,)
</p>
</dd>
<dt><b>[Fos88]</b></dt>
<dd><p>Foss, C. L. Effective Browsing in Hypertext Systems.
<em>Proceedings of the Conference on User-Oriented Content-Based Text and
Image Handling (RIAO 88)</em>, March 21-24, MIT, Cambridge MA. Centre de Hautes
Etudes Internationales d&rsquo;Informatique Documentaire, 1988, pp. 82-98.
</p>
</dd>
<dt><b>[GaSmMe86]</b></dt>
<dd><p>Garrett, N., K. E. Smith and N. Meyrowitz. Intermedia: Issues,
Strategies, and Tactics in the Design of a Hypermedia Document System.
<em>Computer-Supported Cooperative Work (CSCW &rsquo;86) Proceedings</em>, December
3-5, Austin, TX, 1986, pp. 163-174.
</p>
</dd>
<dt><b>[HaMoTr87]</b></dt>
<dd><p>Halasz, F. G., T. P. Moran and R. H. Trigg. NoteCards in a
Nutshell. <em>Proceedings of the CHI and GI &rsquo;87 Conference on Human Factors
in Computing Systems</em>, Toronto, J. M. Carroll and P. P. Tanner, (editors),
ACM: NY, NY, April 1987, pp. 45-52.
</p>
</dd>
<dt><b>[Har88]</b></dt>
<dd><p>Harvey, G. <em>Understanding HyperCard.</em> Alameda, CA: SYBEX, Inc.,
1988.
</p>
</dd>
<dt><b>[KaKaBeLaDr90]</b></dt>
<dd><p>Kaplan, S. J., M. D. Kapor, E. J. Belove, R. A.  Landsman, and
T. R. Drake.  AGENDA: A personal Information Manager.  <em>Communications
of the ACM</em>, No. 33, July 1990, pp. 105-116.
</p>
</dd>
<dt><b>[Nel87a]</b></dt>
<dd><p>Nelson, T. H.  <em>Computer Lib/Dream Machines.</em> MicroSoft Press,
Redmond, WA, 1987.
</p>
</dd>
<dt><b>[Nel87b]</b></dt>
<dd><p>Nelson, T. H. <em>Literary Machines, Edition 87.1</em>.  Available
from the Distributors, 702 South Michigan, South Bend, IN 46618, 1987.
</p>
</dd>
<dt><b>[NoDr86]</b></dt>
<dd><p>Norman, D. A. and S. W. Draper, editors.  <em>User Centered System
Design.</em> Lawrence Erlbaum Associates: Hillsdale, New Jersey, 1986.
</p>
</dd>
<dt><b>[Shn82]</b></dt>
<dd><p>Shneiderman, B. The future of interactive systems and the emergence
of direct manipulation.  <em>Behavior and Information Technology</em>, Vol. 1,
1982, pp. 237-256.
</p>
</dd>
<dt><b>[Sta87]</b></dt>
<dd><p>Stallman, R.  <em>GNU Emacs Manual.</em> Free Software Foundation,
Cambridge: MA, March 1987.
</p>
</dd>
<dt><b>[Tri86]</b></dt>
<dd><p>Trigg, R., L. Suchman, and F. Halasz.  Supporting collaboration in
NoteCards.  <em>Proceedings of the CSCW &rsquo;86 Conference</em>, Austin, TX,
December 1986, pp. 147-153.
</p>
</dd>
<dt><b>[TrMoHa87]</b></dt>
<dd><p>Trigg, R. H., T. P. Moran and F. G. Halasz.  Adaptability and
Tailorability in NoteCards. <em>Proceedings of INTERACT &rsquo;87</em>, Stuttgart,
West Germany, September 1987.
</p>
</dd>
<dt><b>[Wei92]</b></dt>
<dd><p>Weiner, B.  <em>PIEmail: A Personalized Information Environment
Mail Tool.</em>  Department of Computer Science Masters Project, Brown
University: Providence, RI, May 10, 1992.
</p>
</dd>
<dt><b>[YaHaMeDr88]</b></dt>
<dd><p>Yankelovich, N., B. J. Haan, N. Meyrowitz and S. M.  Drucker.
Intermedia: The Concept and the Construction of a Seamless Information
Environment. <em>IEEE Computer</em>, Vol. 21, No. 1, January 1988, pp.  81-96.
</p>
</dd>
<dt><b>[YoAkMc89]</b></dt>
<dd><p>Yoder, E. A., R. M. Akscyn and D. L. McCracken.  Collaboration in
KMS, A Shared Hypermedia System. <em>Proceedings of the 1989 ACM Conference
on Human Factors in Computer Systems (CHI &rsquo;89)</em>, April 30-May 4, 1989,
Austin, TX, ACM: NY,NY, 1989, pp. 37-42.
</p>
</dd>
</dl>



<hr>
<a name="Key-Index"></a>
<div class="header">
<p>
Next: <a href="#Function" accesskey="n" rel="next">Function</a>, Previous: <a href="#References" accesskey="p" rel="prev">References</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Key-Index-1"></a>
<h2 class="unnumbered">Key Index</h2>

<table><tr><th valign="top">Jump to: &nbsp; </th><td><a class="summary-letter" href="#Key-Index_ky_symbol-1"><b>%</b></a>
 &nbsp; 
<a class="summary-letter" href="#Key-Index_ky_symbol-2"><b>(</b></a>
 &nbsp; 
<a class="summary-letter" href="#Key-Index_ky_symbol-3"><b>)</b></a>
 &nbsp; 
<a class="summary-letter" href="#Key-Index_ky_symbol-4"><b>+</b></a>
 &nbsp; 
<a class="summary-letter" href="#Key-Index_ky_symbol-5"><b>,</b></a>
 &nbsp; 
<a class="summary-letter" href="#Key-Index_ky_symbol-6"><b>-</b></a>
 &nbsp; 
<a class="summary-letter" href="#Key-Index_ky_symbol-7"><b>.</b></a>
 &nbsp; 
<a class="summary-letter" href="#Key-Index_ky_symbol-8"><b>0</b></a>
 &nbsp; 
<a class="summary-letter" href="#Key-Index_ky_symbol-9"><b>=</b></a>
 &nbsp; 
<a class="summary-letter" href="#Key-Index_ky_symbol-10"><b>?</b></a>
 &nbsp; 
<a class="summary-letter" href="#Key-Index_ky_symbol-11"><b>@</b></a>
 &nbsp; 
<a class="summary-letter" href="#Key-Index_ky_symbol-12"><b>[</b></a>
 &nbsp; 
<a class="summary-letter" href="#Key-Index_ky_symbol-13"><b>]</b></a>
 &nbsp; 
<a class="summary-letter" href="#Key-Index_ky_symbol-14"><b>~</b></a>
 &nbsp; 
<br>
<a class="summary-letter" href="#Key-Index_ky_letter-A"><b>A</b></a>
 &nbsp; 
<a class="summary-letter" href="#Key-Index_ky_letter-B"><b>B</b></a>
 &nbsp; 
<a class="summary-letter" href="#Key-Index_ky_letter-C"><b>C</b></a>
 &nbsp; 
<a class="summary-letter" href="#Key-Index_ky_letter-D"><b>D</b></a>
 &nbsp; 
<a class="summary-letter" href="#Key-Index_ky_letter-F"><b>F</b></a>
 &nbsp; 
<a class="summary-letter" href="#Key-Index_ky_letter-H"><b>H</b></a>
 &nbsp; 
<a class="summary-letter" href="#Key-Index_ky_letter-I"><b>I</b></a>
 &nbsp; 
<a class="summary-letter" href="#Key-Index_ky_letter-J"><b>J</b></a>
 &nbsp; 
<a class="summary-letter" href="#Key-Index_ky_letter-K"><b>K</b></a>
 &nbsp; 
<a class="summary-letter" href="#Key-Index_ky_letter-L"><b>L</b></a>
 &nbsp; 
<a class="summary-letter" href="#Key-Index_ky_letter-M"><b>M</b></a>
 &nbsp; 
<a class="summary-letter" href="#Key-Index_ky_letter-N"><b>N</b></a>
 &nbsp; 
<a class="summary-letter" href="#Key-Index_ky_letter-O"><b>O</b></a>
 &nbsp; 
<a class="summary-letter" href="#Key-Index_ky_letter-P"><b>P</b></a>
 &nbsp; 
<a class="summary-letter" href="#Key-Index_ky_letter-Q"><b>Q</b></a>
 &nbsp; 
<a class="summary-letter" href="#Key-Index_ky_letter-R"><b>R</b></a>
 &nbsp; 
<a class="summary-letter" href="#Key-Index_ky_letter-S"><b>S</b></a>
 &nbsp; 
<a class="summary-letter" href="#Key-Index_ky_letter-T"><b>T</b></a>
 &nbsp; 
<a class="summary-letter" href="#Key-Index_ky_letter-U"><b>U</b></a>
 &nbsp; 
<a class="summary-letter" href="#Key-Index_ky_letter-W"><b>W</b></a>
 &nbsp; 
<a class="summary-letter" href="#Key-Index_ky_letter-Z"><b>Z</b></a>
 &nbsp; 
</td></tr></table>
<table class="index-ky" border="0">
<tr><td></td><th align="left">Index Entry</th><td>&nbsp;</td><th align="left"> Section</th></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Key-Index_ky_symbol-1">%</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-_0025"><code>%</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Key-Index_ky_symbol-2">(</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-_0028"><code>(</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Key-Index_ky_symbol-3">)</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-_0029"><code>)</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Key-Index_ky_symbol-4">+</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-_002b"><code>+</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Key-Index_ky_symbol-5">,</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-_002c-or-_003e"><code>, or &gt;</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Keys">HyRolo Keys</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Key-Index_ky_symbol-6">-</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-_002d"><code>-</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Key-Index_ky_symbol-7">.</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-_002e"><code>.</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_002e-or-_003c"><code>. or &lt;</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Keys">HyRolo Keys</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Key-Index_ky_symbol-8">0</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-0_002d9"><code>0-9</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Key-Index_ky_symbol-9">=</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-_003d"><code>=</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Key-Index_ky_symbol-10">?</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-_003f"><code>?</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Key-Index_ky_symbol-11">@</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-_0040"><code>@</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Key-Index_ky_symbol-12">[</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005b"><code>[</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Key-Index_ky_symbol-13">]</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-_005d"><code>]</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Key-Index_ky_symbol-14">~</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-_007e"><code>~</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Key-Index_ky_letter-A">A</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-a"><code>a</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-A"><code>A</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Action-Key-1"><code>Action Key</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Keys">Smart Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Action-Key_002c-web-browsing-1"><code>Action Key, web browsing</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Assist-Key-1"><code>Assist Key</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Keys">Smart Keys</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Key-Index_ky_letter-B">B</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-b"><code>b</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-b-1"><code>b</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Keys">HyRolo Keys</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Key-Index_ky_letter-C">C</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-c"><code>c</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dc-_0024"><code>C-c $</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Moving-Around">Moving Around</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dc-_002c"><code>C-c ,</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Moving-Around">Moving Around</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dc-_002e"><code>C-c .</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Thing-Selection">Smart Key Thing Selection</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dc-_002e-1"><code>C-c .</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Moving-Around">Moving Around</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dc-_002e-2"><code>C-c .</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Default-Global-Bindings">Default Global Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dc-_002f"><code>C-c /</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dc-_002f-1"><code>C-c /</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Default-Global-Bindings">Default Global Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dc-_002f-2"><code>C-c /</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Default-Global-Bindings">Default Global Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dc-_003c"><code>C-c &lt;</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Moving-Around">Moving Around</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dc-_003e"><code>C-c &gt;</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Moving-Around">Moving Around</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dc-_0040"><code>C-c @</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Relocating-and-Copying">Relocating and Copying</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dc-_0040-1"><code>C-c @</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Default-Global-Bindings">Default Global Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dc-_0040-2"><code>C-c @</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Default-Global-Bindings">Default Global Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dc-c"><code>C-c c</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Relocating-and-Copying">Relocating and Copying</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dc-C_002da"><code>C-c C-a</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hiding-and-Showing">Hiding and Showing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dc-C_002db"><code>C-c C-b</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Moving-Around">Moving Around</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dc-C_002dc"><code>C-c C-c</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dc-C_002dc-1"><code>C-c C-c</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Relocating-and-Copying">Relocating and Copying</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dc-C_002dd"><code>C-c C-d</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Moving-Around">Moving Around</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dc-C_002df"><code>C-c C-f</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Moving-Around">Moving Around</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dc-C_002dh"><code>C-c C-h</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hiding-and-Showing">Hiding and Showing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dc-C_002dm"><code>C-c C-m</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Relocating-and-Copying">Relocating and Copying</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dc-C_002dn"><code>C-c C-n</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Moving-Around">Moving Around</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dc-C_002do"><code>C-c C-o</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hiding-and-Showing">Hiding and Showing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dc-C_002dp"><code>C-c C-p</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Moving-Around">Moving Around</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dc-C_002ds"><code>C-c C-s</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hiding-and-Showing">Hiding and Showing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dc-C_002dt"><code>C-c C-t</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hiding-and-Showing">Hiding and Showing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dc-C_002du"><code>C-c C-u</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Moving-Around">Moving Around</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dc-C_002dy"><code>C-c C-y</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Buttons-in-Mail">Buttons in Mail</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dc-h"><code>C-c h</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Bindings">Smart Key Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dc-h-1"><code>C-c h</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Default-Global-Bindings">Default Global Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dc-m"><code>C-c m</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Relocating-and-Copying">Relocating and Copying</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dc-M_002dc"><code>C-c M-c</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Relocating-and-Copying">Relocating and Copying</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dc-RET"><code>C-c <span class="key">RET</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Thing-Selection">Smart Key Thing Selection</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dc-RET-1"><code>C-c <span class="key">RET</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Default-Global-Bindings">Default Global Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dc-t"><code>C-c t</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Default-Global-Bindings">Default Global Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dc-_005c"><code>C-c \</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dc-_005c-1"><code>C-c \</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Default-Global-Bindings">Default Global Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dc-_005e"><code>C-c ^</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Moving-Around">Moving Around</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dg"><code>C-g</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dh-A"><code>C-h A</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Operations">Smart Key Operations</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dh-A-1"><code>C-h A</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Default-Global-Bindings">Default Global Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dh-h"><code>C-h h</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dh-h-1"><code>C-h h</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Default-Global-Bindings">Default Global Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dh-h-c-a"><code>C-h h c a</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Customization">Customization</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dh-h-c-d"><code>C-h h c d</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Debugging">Smart Key Debugging</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dh-h-c-r"><code>C-h h c r</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Internal-Viewers">Internal Viewers</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dh-h-c-u"><code>C-h h c u</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Using-URLs-with-Find_002dFile">Using URLs with Find-File</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dh-h-c-u-1"><code>C-h h c u</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-WWW-URLs">Smart Key - WWW URLs</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dh-h-c-w"><code>C-h h c w</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Web-Search-Engines">Web Search Engines</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dh-h-d-d"><code>C-h h d d</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hyperbole-Overview">Hyperbole Overview</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dh-h-d-i"><code>C-h h d i</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Invocation">Invocation</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dh-h-f-w"><code>C-h h f w</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Web-Search-Engines">Web Search Engines</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dh-h-f-w-1"><code>C-h h f w</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Default-Global-Bindings">Default Global Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dh-h-g"><code>C-h h g</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Global-Buttons">Global Buttons</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dh-h-i-a"><code>C-h h i a</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Buttons">Implicit Buttons</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dh-h-k-e"><code>C-h h k e</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner">Koutliner</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dh-h-m-c"><code>C-h h m c</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Debugging">Smart Key Debugging</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dh-h-m-r"><code>C-h h m r</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Debugging">Smart Key Debugging</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dh-h-s-f"><code>C-h h s f</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dh-h-s-w"><code>C-h h s w</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dh-t"><code>C-h t</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hyperbole-Overview">Hyperbole Overview</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dM_002dh"><code>C-M-h</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hiding-and-Showing">Hiding and Showing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dM_002dx"><code>C-M-x</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Creating-Types">Creating Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dmouse_002d3"><code>C-mouse-3</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menu-Commands">Menu Commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dmouse_002d3-1"><code>C-mouse-3</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Menu">HyRolo Menu</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dt"><code>C-t</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002du-C_002dc-c"><code>C-u C-c c</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Relocating-and-Copying">Relocating and Copying</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002du-C_002dc-C_002dc"><code>C-u C-c C-c</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Relocating-and-Copying">Relocating and Copying</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002du-C_002dc-C_002dm"><code>C-u C-c C-m</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Relocating-and-Copying">Relocating and Copying</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002du-C_002dc-m"><code>C-u C-c m</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Relocating-and-Copying">Relocating and Copying</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002du-C_002dh-A"><code>C-u C-h A</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Operations">Smart Key Operations</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002du-C_002dh-A-1"><code>C-u C-h A</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Default-Global-Bindings">Default Global Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002du-M_002do"><code>C-u M-o</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Keyboard-Drags">Keyboard Drags</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002du-M_002dRET"><code>C-u M-<span class="key">RET</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Bindings">Smart Key Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002du-M_002dRET-1"><code>C-u M-<span class="key">RET</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Default-Global-Bindings">Default Global Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dx-_0024"><code>C-x $</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hiding-and-Showing">Hiding and Showing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dx-_002b"><code>C-x +</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Creating-and-Deleting-Windows">Creating and Deleting Windows</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dx-C_002de"><code>C-x C-e</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Creating-Types">Creating Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dx-m"><code>C-x m</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Buttons-in-Mail">Buttons in Mail</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002dx-o"><code>C-x o</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Keyboard-Drags">Keyboard Drags</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Key-Index_ky_letter-D">D</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-d"><code>d</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-D"><code>D</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-DEL"><code><span class="key">DEL</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Keys">HyRolo Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-down"><code>down</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Key-Index_ky_letter-F">F</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-f"><code>f</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-F"><code>F</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-f-1"><code>f</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Keys">HyRolo Keys</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Key-Index_ky_letter-H">H</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-h"><code>h</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-H"><code>H</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-HyControl_002c-see-screen"><code>HyControl, see screen</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-HyControl_002c-see-screen-1"><code>HyControl, see screen</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-HyRolo_002c-see-rolo"><code>HyRolo, see rolo</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Keys">HyRolo Keys</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Key-Index_ky_letter-I">I</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-i"><code>i</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Key-Index_ky_letter-J">J</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-j"><code>j</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Key-Index_ky_letter-K">K</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-k"><code>k</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-keypad-number"><code>keypad number</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-koutliner_002c-Action-Key_002c-cell-argument"><code>koutliner, Action Key, cell argument</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Relocating-and-Copying">Relocating and Copying</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-koutliner_002c-Action-Key_002c-hide-or-show-cell"><code>koutliner, Action Key, hide or show cell</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hiding-and-Showing">Hiding and Showing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-koutliner_002c-Action-Key_002c-klink"><code>koutliner, Action Key, klink</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Links">Links</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-koutliner_002c-Assist-Key_002c-listing-attributes"><code>koutliner, Assist Key, listing attributes</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Cell-Attributes">Cell Attributes</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-koutliner_002c-C_002dc-_002b"><code>koutliner, C-c +</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Splitting-and-Appending">Splitting and Appending</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-koutliner_002c-C_002dc-a"><code>koutliner, C-c a</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Adding-and-Killing">Adding and Killing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-koutliner_002c-C_002dc-b"><code>koutliner, C-c b</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#View-Specs">View Specs</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-koutliner_002c-C_002dc-b-1"><code>koutliner, C-c b</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#View-Specs">View Specs</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-koutliner_002c-C_002dc-C_002di"><code>koutliner, C-c C-i</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Cell-Attributes">Cell Attributes</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-koutliner_002c-C_002dc-C_002dk"><code>koutliner, C-c C-k</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Adding-and-Killing">Adding and Killing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-koutliner_002c-C_002dc-C_002dl"><code>koutliner, C-c C-l</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Autonumbering">Autonumbering</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-koutliner_002c-C_002dc-C_002dv"><code>koutliner, C-c C-v</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#View-Specs">View Specs</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-koutliner_002c-C_002dc-e"><code>koutliner, C-c e</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Transposing">Transposing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-koutliner_002c-C_002dc-h"><code>koutliner, C-c h</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Cell-Attributes">Cell Attributes</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-koutliner_002c-C_002dc-k"><code>koutliner, C-c k</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Adding-and-Killing">Adding and Killing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-koutliner_002c-C_002dc-l"><code>koutliner, C-c l</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Links">Links</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-koutliner_002c-C_002dc-M_002dj"><code>koutliner, C-c M-j</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Filling">Filling</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-koutliner_002c-C_002dc-M_002dl"><code>koutliner, C-c M-l</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Autonumbering">Autonumbering</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-koutliner_002c-C_002dc-M_002dq"><code>koutliner, C-c M-q</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Filling">Filling</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-koutliner_002c-C_002dc-p"><code>koutliner, C-c p</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Adding-and-Killing">Adding and Killing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-koutliner_002c-C_002dc-s"><code>koutliner, C-c s</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Splitting-and-Appending">Splitting and Appending</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-koutliner_002c-C_002dc-t"><code>koutliner, C-c t</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Transposing">Transposing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-koutliner_002c-C_002dj"><code>koutliner, C-j</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Adding-and-Killing">Adding and Killing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-koutliner_002c-C_002dM_002dj"><code>koutliner, C-M-j</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Filling">Filling</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-koutliner_002c-C_002dM_002dq"><code>koutliner, C-M-q</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Filling">Filling</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-koutliner_002c-C_002du-C_002dc-h"><code>koutliner, C-u C-c h</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Cell-Attributes">Cell Attributes</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-koutliner_002c-C_002du-C_002dc-k"><code>koutliner, C-u C-c k</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Adding-and-Killing">Adding and Killing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-koutliner_002c-C_002du-C_002dc-M_002dl"><code>koutliner, C-u C-c M-l</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Autonumbering">Autonumbering</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-koutliner_002c-C_002du-C_002dc-s"><code>koutliner, C-u C-c s</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Splitting-and-Appending">Splitting and Appending</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-koutliner_002c-C_002du-c_002dj"><code>koutliner, C-u c-j</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Adding-and-Killing">Adding and Killing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-koutliner_002c-C_002du-C_002dx-i"><code>koutliner, C-u C-x i</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Inserting-and-Importing">Inserting and Importing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-koutliner_002c-C_002dx-i"><code>koutliner, C-x i</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Inserting-and-Importing">Inserting and Importing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-koutliner_002c-C_002dy"><code>koutliner, C-y</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Adding-and-Killing">Adding and Killing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-koutliner_002c-M_002d0-C_002dc-t"><code>koutliner, M-0 C-c t</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Transposing">Transposing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-koutliner_002c-M_002d1-TAB"><code>koutliner, M-1 <span class="key">TAB</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Relocating-and-Copying">Relocating and Copying</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-koutliner_002c-M_002dj"><code>koutliner, M-j</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Filling">Filling</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-koutliner_002c-M_002dq"><code>koutliner, M-q</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Filling">Filling</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-koutliner_002c-M_002dRET"><code>koutliner, M-<span class="key">RET</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hiding-and-Showing">Hiding and Showing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-koutliner_002c-M_002dTAB"><code>koutliner, M-<span class="key">TAB</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Relocating-and-Copying">Relocating and Copying</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-koutliner_002c-TAB"><code>koutliner, <span class="key">TAB</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Relocating-and-Copying">Relocating and Copying</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Key-Index_ky_letter-L">L</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-l"><code>l</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-left"><code>left</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Key-Index_ky_letter-M">M</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-m"><code>m</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-M_002db"><code>M-b</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-M_002df"><code>M-f</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-M_002do"><code>M-o</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Keyboard-Drags">Keyboard Drags</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-M_002do-1"><code>M-o</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Default-Global-Bindings">Default Global Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-M_002do-i-_003cwindow_002did_003e"><code>M-o i &lt;window-id&gt;</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Keyboard-Drags">Keyboard Drags</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-M_002do-m-_003cwindow_002did_003e"><code>M-o m &lt;window-id&gt;</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Keyboard-Drags">Keyboard Drags</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-M_002do-r-_003cwindow_002did_003e"><code>M-o r &lt;window-id&gt;</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Keyboard-Drags">Keyboard Drags</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-M_002do-t-_003cwindow_002did_003e"><code>M-o t &lt;window-id&gt;</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Keyboard-Drags">Keyboard Drags</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-M_002do-w-_003cwindow_002did_003e"><code>M-o w &lt;window-id&gt;</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Keyboard-Drags">Keyboard Drags</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-M_002dRET"><code>M-<span class="key">RET</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Bindings">Smart Key Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-M_002dRET-1"><code>M-<span class="key">RET</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-M_002dRET-2"><code>M-<span class="key">RET</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Default-Global-Bindings">Default Global Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-M_002dx-kotl_002dmode_003ashow_002dsubtree"><code>M-x kotl-mode:show-subtree</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hiding-and-Showing">Hiding and Showing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-middle-mouse-key-1"><code>middle mouse key</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Bindings">Smart Key Bindings</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Key-Index_ky_letter-N">N</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-n"><code>n</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-n-1"><code>n</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Keys">HyRolo Keys</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Key-Index_ky_letter-O">O</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-o"><code>o</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-O"><code>O</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Key-Index_ky_letter-P">P</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-p"><code>p</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-p-1"><code>p</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Keys">HyRolo Keys</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Key-Index_ky_letter-Q">Q</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-q"><code>q</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Q"><code>Q</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-q-1"><code>q</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Key-Index_ky_letter-R">R</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-r"><code>r</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-right"><code>right</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-rolo_002c-_002c"><code>rolo, ,</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Keys">HyRolo Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-rolo_002c-_002e"><code>rolo, .</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Keys">HyRolo Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-rolo_002c-_003c"><code>rolo, &lt;</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Keys">HyRolo Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-rolo_002c-_003e"><code>rolo, &gt;</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Keys">HyRolo Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-rolo_002c-a"><code>rolo, a</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Keys">HyRolo Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-rolo_002c-b"><code>rolo, b</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Keys">HyRolo Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-rolo_002c-C_002dr"><code>rolo, C-r</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Keys">HyRolo Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-rolo_002c-C_002ds"><code>rolo, C-s</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Keys">HyRolo Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-rolo_002c-DEL"><code>rolo, <span class="key">DEL</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Keys">HyRolo Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-rolo_002c-e"><code>rolo, e</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Keys">HyRolo Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-rolo_002c-f"><code>rolo, f</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Keys">HyRolo Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-rolo_002c-h"><code>rolo, h</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Keys">HyRolo Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-rolo_002c-l"><code>rolo, l</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Keys">HyRolo Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-rolo_002c-M_002ds"><code>rolo, M-s</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Keys">HyRolo Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-rolo_002c-M_002dTAB"><code>rolo, M-<span class="key">TAB</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Keys">HyRolo Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-rolo_002c-n"><code>rolo, n</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Keys">HyRolo Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-rolo_002c-o"><code>rolo, o</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Keys">HyRolo Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-rolo_002c-p"><code>rolo, p</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Keys">HyRolo Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-rolo_002c-q"><code>rolo, q</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Keys">HyRolo Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-rolo_002c-r"><code>rolo, r</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Keys">HyRolo Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-rolo_002c-s"><code>rolo, s</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Keys">HyRolo Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-rolo_002c-SHIFT_002dTAB"><code>rolo, <span class="key">SHIFT</span>-<span class="key">TAB</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Keys">HyRolo Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-rolo_002c-SPC"><code>rolo, <span class="key">SPC</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Keys">HyRolo Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-rolo_002c-t"><code>rolo, t</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Keys">HyRolo Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-rolo_002c-TAB"><code>rolo, <span class="key">TAB</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Keys">HyRolo Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-rolo_002c-u"><code>rolo, u</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Keys">HyRolo Keys</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Key-Index_ky_letter-S">S</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-s"><code>s</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-screen_002c-_0025"><code>screen, %</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-screen_002c-_0028"><code>screen, (</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-screen_002c-_0029"><code>screen, )</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-screen_002c-_002b"><code>screen, +</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-screen_002c-_002d"><code>screen, -</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-screen_002c-_002e"><code>screen, .</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-screen_002c-0_002d9"><code>screen, 0-9</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-screen_002c-_003d"><code>screen, =</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-screen_002c-_003f"><code>screen, ?</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-screen_002c-_0040"><code>screen, @</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-screen_002c-a"><code>screen, a</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-screen_002c-A"><code>screen, A</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-screen_002c-b"><code>screen, b</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-screen_002c-c"><code>screen, c</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-screen_002c-C_002dc-_005c"><code>screen, C-c \</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-screen_002c-C_002dh-h-s-f"><code>screen, C-h h s f</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-screen_002c-C_002dh-h-s-w"><code>screen, C-h h s w</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-screen_002c-d"><code>screen, d</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-screen_002c-D"><code>screen, D</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-screen_002c-down"><code>screen, down</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-screen_002c-f"><code>screen, f</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-screen_002c-F"><code>screen, F</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-screen_002c-h"><code>screen, h</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-screen_002c-H"><code>screen, H</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-screen_002c-i"><code>screen, i</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-screen_002c-j"><code>screen, j</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-screen_002c-k"><code>screen, k</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-screen_002c-keypad-number"><code>screen, keypad number</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-screen_002c-l"><code>screen, l</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-screen_002c-left"><code>screen, left</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-screen_002c-m"><code>screen, m</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-screen_002c-n"><code>screen, n</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-screen_002c-o"><code>screen, o</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-screen_002c-O"><code>screen, O</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-screen_002c-p"><code>screen, p</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-screen_002c-q"><code>screen, q</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-screen_002c-Q"><code>screen, Q</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-screen_002c-Q-1"><code>screen, Q</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-screen_002c-q-1"><code>screen, q</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-screen_002c-r"><code>screen, r</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-screen_002c-right"><code>screen, right</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-screen_002c-s"><code>screen, s</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-screen_002c-t"><code>screen, t</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-screen_002c-t-1"><code>screen, t</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-screen_002c-u"><code>screen, u</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-screen_002c-up"><code>screen, up</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-screen_002c-w"><code>screen, w</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-screen_002c-W"><code>screen, W</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-screen_002c-Z"><code>screen, Z</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-screen_002c-z"><code>screen, z</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-screen_002c-_005b"><code>screen, [</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-screen_002c-_005d"><code>screen, ]</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-screen_002c-_007e"><code>screen, ~</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-shift_002dleft-mouse-key"><code>shift-left mouse key</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Bindings">Smart Key Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-shift_002dmiddle-mouse-key"><code>shift-middle mouse key</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Bindings">Smart Key Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-shift_002dright-mouse-key"><code>shift-right mouse key</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Bindings">Smart Key Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Shift_002dTAB"><code>Shift-<span class="key">TAB</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-SPC"><code><span class="key">SPC</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Keys">HyRolo Keys</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Key-Index_ky_letter-T">T</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-t"><code>t</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-TAB"><code><span class="key">TAB</span></code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Key-Index_ky_letter-U">U</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-u"><code>u</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-u-1"><code>u</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Keys">HyRolo Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-up"><code>up</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Key-Index_ky_letter-W">W</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-w"><code>w</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-W"><code>W</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Key-Index_ky_letter-Z">Z</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-Z"><code>Z</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-z"><code>z</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
</table>
<table><tr><th valign="top">Jump to: &nbsp; </th><td><a class="summary-letter" href="#Key-Index_ky_symbol-1"><b>%</b></a>
 &nbsp; 
<a class="summary-letter" href="#Key-Index_ky_symbol-2"><b>(</b></a>
 &nbsp; 
<a class="summary-letter" href="#Key-Index_ky_symbol-3"><b>)</b></a>
 &nbsp; 
<a class="summary-letter" href="#Key-Index_ky_symbol-4"><b>+</b></a>
 &nbsp; 
<a class="summary-letter" href="#Key-Index_ky_symbol-5"><b>,</b></a>
 &nbsp; 
<a class="summary-letter" href="#Key-Index_ky_symbol-6"><b>-</b></a>
 &nbsp; 
<a class="summary-letter" href="#Key-Index_ky_symbol-7"><b>.</b></a>
 &nbsp; 
<a class="summary-letter" href="#Key-Index_ky_symbol-8"><b>0</b></a>
 &nbsp; 
<a class="summary-letter" href="#Key-Index_ky_symbol-9"><b>=</b></a>
 &nbsp; 
<a class="summary-letter" href="#Key-Index_ky_symbol-10"><b>?</b></a>
 &nbsp; 
<a class="summary-letter" href="#Key-Index_ky_symbol-11"><b>@</b></a>
 &nbsp; 
<a class="summary-letter" href="#Key-Index_ky_symbol-12"><b>[</b></a>
 &nbsp; 
<a class="summary-letter" href="#Key-Index_ky_symbol-13"><b>]</b></a>
 &nbsp; 
<a class="summary-letter" href="#Key-Index_ky_symbol-14"><b>~</b></a>
 &nbsp; 
<br>
<a class="summary-letter" href="#Key-Index_ky_letter-A"><b>A</b></a>
 &nbsp; 
<a class="summary-letter" href="#Key-Index_ky_letter-B"><b>B</b></a>
 &nbsp; 
<a class="summary-letter" href="#Key-Index_ky_letter-C"><b>C</b></a>
 &nbsp; 
<a class="summary-letter" href="#Key-Index_ky_letter-D"><b>D</b></a>
 &nbsp; 
<a class="summary-letter" href="#Key-Index_ky_letter-F"><b>F</b></a>
 &nbsp; 
<a class="summary-letter" href="#Key-Index_ky_letter-H"><b>H</b></a>
 &nbsp; 
<a class="summary-letter" href="#Key-Index_ky_letter-I"><b>I</b></a>
 &nbsp; 
<a class="summary-letter" href="#Key-Index_ky_letter-J"><b>J</b></a>
 &nbsp; 
<a class="summary-letter" href="#Key-Index_ky_letter-K"><b>K</b></a>
 &nbsp; 
<a class="summary-letter" href="#Key-Index_ky_letter-L"><b>L</b></a>
 &nbsp; 
<a class="summary-letter" href="#Key-Index_ky_letter-M"><b>M</b></a>
 &nbsp; 
<a class="summary-letter" href="#Key-Index_ky_letter-N"><b>N</b></a>
 &nbsp; 
<a class="summary-letter" href="#Key-Index_ky_letter-O"><b>O</b></a>
 &nbsp; 
<a class="summary-letter" href="#Key-Index_ky_letter-P"><b>P</b></a>
 &nbsp; 
<a class="summary-letter" href="#Key-Index_ky_letter-Q"><b>Q</b></a>
 &nbsp; 
<a class="summary-letter" href="#Key-Index_ky_letter-R"><b>R</b></a>
 &nbsp; 
<a class="summary-letter" href="#Key-Index_ky_letter-S"><b>S</b></a>
 &nbsp; 
<a class="summary-letter" href="#Key-Index_ky_letter-T"><b>T</b></a>
 &nbsp; 
<a class="summary-letter" href="#Key-Index_ky_letter-U"><b>U</b></a>
 &nbsp; 
<a class="summary-letter" href="#Key-Index_ky_letter-W"><b>W</b></a>
 &nbsp; 
<a class="summary-letter" href="#Key-Index_ky_letter-Z"><b>Z</b></a>
 &nbsp; 
</td></tr></table>

<hr>
<a name="Function"></a>
<div class="header">
<p>
Next: <a href="#Concept-Index" accesskey="n" rel="next">Concept Index</a>, Previous: <a href="#Key-Index" accesskey="p" rel="prev">Key Index</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Function_002c-Variable-and-File-Index"></a>
<h2 class="unnumbered">Function, Variable and File Index</h2>

<table><tr><th valign="top">Jump to: &nbsp; </th><td><a class="summary-letter" href="#Function_fn_letter-A"><b>A</b></a>
 &nbsp; 
<a class="summary-letter" href="#Function_fn_letter-B"><b>B</b></a>
 &nbsp; 
<a class="summary-letter" href="#Function_fn_letter-C"><b>C</b></a>
 &nbsp; 
<a class="summary-letter" href="#Function_fn_letter-D"><b>D</b></a>
 &nbsp; 
<a class="summary-letter" href="#Function_fn_letter-E"><b>E</b></a>
 &nbsp; 
<a class="summary-letter" href="#Function_fn_letter-F"><b>F</b></a>
 &nbsp; 
<a class="summary-letter" href="#Function_fn_letter-G"><b>G</b></a>
 &nbsp; 
<a class="summary-letter" href="#Function_fn_letter-H"><b>H</b></a>
 &nbsp; 
<a class="summary-letter" href="#Function_fn_letter-I"><b>I</b></a>
 &nbsp; 
<a class="summary-letter" href="#Function_fn_letter-K"><b>K</b></a>
 &nbsp; 
<a class="summary-letter" href="#Function_fn_letter-L"><b>L</b></a>
 &nbsp; 
<a class="summary-letter" href="#Function_fn_letter-M"><b>M</b></a>
 &nbsp; 
<a class="summary-letter" href="#Function_fn_letter-O"><b>O</b></a>
 &nbsp; 
<a class="summary-letter" href="#Function_fn_letter-R"><b>R</b></a>
 &nbsp; 
<a class="summary-letter" href="#Function_fn_letter-S"><b>S</b></a>
 &nbsp; 
<a class="summary-letter" href="#Function_fn_letter-W"><b>W</b></a>
 &nbsp; 
<a class="summary-letter" href="#Function_fn_letter-Z"><b>Z</b></a>
 &nbsp; 
</td></tr></table>
<table class="index-fn" border="0">
<tr><td></td><th align="left">Index Entry</th><td>&nbsp;</td><th align="left"> Section</th></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Function_fn_letter-A">A</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-ace_002dwindow-1"><code>ace-window</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Keyboard-Drags">Keyboard Drags</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-action_002dact_002dhook">action-act-hook</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hook-Variables">Hook Variables</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-action_002dkey"><code>action-key</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Bindings">Smart Key Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-action_002dkey_002ddefault_002dfunction">action-key-default-function</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Operations">Smart Key Operations</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-action_002dkey_002ddefault_002dfunction-1">action-key-default-function</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Default-Context">Smart Key - Default Context</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-action_002dkey_002ddepress_002dhook">action-key-depress-hook</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hook-Variables">Hook Variables</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-action_002dkey_002deol_002dfunction">action-key-eol-function</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Smart-Scrolling">Smart Key - Smart Scrolling</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-action_002dkey_002dminibuffer_002dfunction">action-key-minibuffer-function</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Minibuffer-Menu-Activation">Minibuffer Menu Activation</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-action_002dkey_002dmodeline"><code>action-key-modeline</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Mouse-Key-Modeline-Clicks">Smart Mouse Key Modeline Clicks</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-action_002dkey_002dmodeline_002dfunction">action-key-modeline-function</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Mouse-Key-Modeline-Clicks">Smart Mouse Key Modeline Clicks</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-action_002dkey_002dmodeline_002dfunction-1">action-key-modeline-function</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Modeline-Clicks-and-Drags">Modeline Clicks and Drags</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-action_002dkey_002drelease_002dhook">action-key-release-hook</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hook-Variables">Hook Variables</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-action_002dmouse_002dkey"><code>action-mouse-key</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Bindings">Smart Key Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-actype_003acreate"><code>actype:create</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Creating-Action-Types">Creating Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-actype_003acreate-1"><code>actype:create</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Creating-Action-Types">Creating Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-actype_003adelete"><code>actype:delete</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Creating-Action-Types">Creating Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-actypes-annot_002dbib"><code>actypes annot-bib</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Action-Types">Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-actypes-completion"><code>actypes completion</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Action-Types">Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-actypes-display_002dvariable"><code>actypes display-variable</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Action-Types">Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-actypes-eval_002delisp"><code>actypes eval-elisp</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Action-Types">Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-actypes-exec_002dkbd_002dmacro"><code>actypes exec-kbd-macro</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Action-Types">Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-actypes-exec_002dshell_002dcmd"><code>actypes exec-shell-cmd</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Action-Types">Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-actypes-exec_002dwindow_002dcmd"><code>actypes exec-window-cmd</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Action-Types">Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-actypes-function_002din_002dbuffer"><code>actypes function-in-buffer</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Action-Types">Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-actypes-hyp_002dconfig"><code>actypes hyp-config</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Action-Types">Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-actypes-hyp_002drequest"><code>actypes hyp-request</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Action-Types">Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-actypes-hyp_002dsource"><code>actypes hyp-source</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Action-Types">Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-actypes-kbd_002dkey"><code>actypes kbd-key</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Action-Types">Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-actypes-link_002dto_002dbookmark"><code>actypes link-to-bookmark</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Action-Types">Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-actypes-link_002dto_002dbuffer_002dtmp"><code>actypes link-to-buffer-tmp</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Action-Types">Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-actypes-link_002dto_002ddirectory"><code>actypes link-to-directory</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Action-Types">Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-actypes-link_002dto_002ddoc"><code>actypes link-to-doc</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Action-Types">Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-actypes-link_002dto_002debut"><code>actypes link-to-ebut</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Action-Types">Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-actypes-link_002dto_002delisp_002ddoc"><code>actypes link-to-elisp-doc</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Action-Types">Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-actypes-link_002dto_002dfile"><code>actypes link-to-file</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Action-Types">Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-actypes-link_002dto_002dfile_002dline"><code>actypes link-to-file-line</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Action-Types">Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-actypes-link_002dto_002dgbut"><code>actypes link-to-gbut</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Action-Types">Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-actypes-link_002dto_002dibut"><code>actypes link-to-ibut</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Action-Types">Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-actypes-link_002dto_002dInfo_002dindex_002ditem"><code>actypes link-to-Info-index-item</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Action-Types">Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-actypes-link_002dto_002dInfo_002dnode"><code>actypes link-to-Info-node</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Action-Types">Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-actypes-link_002dto_002dkcell"><code>actypes link-to-kcell</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Action-Types">Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-actypes-link_002dto_002dkotl"><code>actypes link-to-kotl</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Action-Types">Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-actypes-link_002dto_002dmail"><code>actypes link-to-mail</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Action-Types">Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-actypes-link_002dto_002dregexp_002dmatch"><code>actypes link-to-regexp-match</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Action-Types">Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-actypes-link_002dto_002drfc"><code>actypes link-to-rfc</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Action-Types">Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-actypes-link_002dto_002dstring_002dmatch"><code>actypes link-to-string-match</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Action-Types">Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-actypes-link_002dto_002dtexinfo_002dnode"><code>actypes link-to-texinfo-node</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Action-Types">Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-actypes-link_002dto_002dweb_002dsearch"><code>actypes link-to-web-search</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Action-Types">Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-actypes-man_002dshow"><code>actypes man-show</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Action-Types">Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-actypes-rfc_002dtoc"><code>actypes rfc-toc</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Action-Types">Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-actypes-text_002dtoc"><code>actypes text-toc</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Action-Types">Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-actypes-www_002durl"><code>actypes www-url</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Action-Types">Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-add_002dhook"><code>add-hook</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hook-Variables">Hook Variables</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-assist_002dkey"><code>assist-key</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Bindings">Smart Key Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-assist_002dkey_002ddefault_002dfunction">assist-key-default-function</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Operations">Smart Key Operations</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-assist_002dkey_002ddefault_002dfunction-1">assist-key-default-function</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Default-Context">Smart Key - Default Context</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-assist_002dkey_002ddepress_002dhook">assist-key-depress-hook</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hook-Variables">Hook Variables</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-assist_002dkey_002deol_002dfunction">assist-key-eol-function</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Smart-Scrolling">Smart Key - Smart Scrolling</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-assist_002dkey_002dminibuffer_002dfunction">assist-key-minibuffer-function</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Minibuffer-Menu-Activation">Minibuffer Menu Activation</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-assist_002dkey_002dmodeline"><code>assist-key-modeline</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Mouse-Key-Modeline-Clicks">Smart Mouse Key Modeline Clicks</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-assist_002dkey_002dmodeline_002dfunction">assist-key-modeline-function</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Mouse-Key-Modeline-Clicks">Smart Mouse Key Modeline Clicks</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-assist_002dkey_002dmodeline_002dfunction-1">assist-key-modeline-function</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Modeline-Clicks-and-Drags">Modeline Clicks and Drags</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-assist_002dkey_002drelease_002dhook">assist-key-release-hook</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hook-Variables">Hook Variables</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-assist_002dmouse_002dkey"><code>assist-mouse-key</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Bindings">Smart Key Bindings</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Function_fn_letter-B">B</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-browse_002durl_002dbrowser_002dfunction">browse-url-browser-function</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-browse_002durl_002dbrowser_002dfunction-1">browse-url-browser-function</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Action-Types">Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-browse_002durl_002dbrowser_002dfunction-2">browse-url-browser-function</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-WWW-URLs">Smart Key - WWW URLs</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Function_fn_letter-C">C</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-c_002b_002b_002dcpp_002dinclude_002dpath">c++-cpp-include-path</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-C_002b_002b-Source-Code">Smart Key - C++ Source Code</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-c_002b_002b_002dinclude_002dpath">c++-include-path</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-C_002b_002b-Source-Code">Smart Key - C++ Source Code</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-class_002c-ebut">class, ebut</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Operational-and-Storage-Formats">Operational and Storage Formats</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-class_002c-ebut-1">class, ebut</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Programmatic-Button-Creation">Programmatic Button Creation</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-class_002c-hargs">class, hargs</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Creating-Action-Types">Creating Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-class_002c-hattr">class, hattr</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Programmatic-Implicit-Button-Types">Programmatic Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-class_002c-hbdata">class, hbdata</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Operational-and-Storage-Formats">Operational and Storage Formats</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-class_002c-hbut">class, hbut</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Programmatic-Implicit-Button-Types">Programmatic Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-class_002c-hbut-1">class, hbut</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Operational-and-Storage-Formats">Operational and Storage Formats</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-class_002c-htype">class, htype</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Creating-Types">Creating Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-customize_002dbrowse"><code>customize-browse</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Customization">Customization</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-customize_002dvariable"><code>customize-variable</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Customization">Customization</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Function_fn_letter-D">D</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-defact"><code>defact</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Creating-Action-Types">Creating Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-defib"><code>defib</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Programmatic-Implicit-Button-Types">Programmatic Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-dir_002c-_007e_002f_002ehyperb">dir, ~/.hyperb</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Button-Files">Button Files</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-dired_002djump"><code>dired-jump</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Mouse-Key-Modeline-Clicks">Smart Mouse Key Modeline Clicks</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-drag_002dwith_002dmode_002dline">drag-with-mode-line</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Moving-Frames">Moving Frames</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Function_fn_letter-E">E</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-ebut_002dcreate_002dhook">ebut-create-hook</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hook-Variables">Hook Variables</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ebut_002ddelete_002dhook">ebut-delete-hook</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hook-Variables">Hook Variables</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ebut_002dmodify_002dhook">ebut-modify-hook</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hook-Variables">Hook Variables</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ebut_003acreate"><code>ebut:create</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Programmatic-Button-Creation">Programmatic Button Creation</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ebut_003amap"><code>ebut:map</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Programmatic-Button-Creation">Programmatic Button Creation</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ebut_003aprogram"><code>ebut:program</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Programmatic-Button-Creation">Programmatic Button Creation</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-emacs_002dversion">emacs-version</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Suggestion-or-Bug-Reporting">Suggestion or Bug Reporting</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-eval_002ddefun"><code>eval-defun</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Creating-Types">Creating Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-eval_002dlast_002dsexp"><code>eval-last-sexp</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Creating-Types">Creating Types</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Function_fn_letter-F">F</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-file_002c-_002eemacs">file, .emacs</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Bindings">Smart Key Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-file_002c-_002eemacs-1">file, .emacs</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Renaming">Renaming</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-file_002c-_002eemacs-2">file, .emacs</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Buttons-in-Mail">Buttons in Mail</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-file_002c-_002eemacs-3">file, .emacs</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Autonumbering">Autonumbering</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-file_002c-_002eemacs-4">file, .emacs</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Default-Global-Bindings">Default Global Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-file_002c-_002eemacs-5">file, .emacs</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Default-Global-Bindings">Default Global Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-file_002c-_002ehypb">file, .hypb</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Explicit-Buttons">Explicit Buttons</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-file_002c-_002ekotl-suffix">file, .kotl suffix</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Creating-Outlines">Creating Outlines</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-file_002c-DEMO-1">file, DEMO</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hyperbole-Overview">Hyperbole Overview</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-file_002c-DIR">file, DIR</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-file_002c-EXAMPLE_002ekotl">file, EXAMPLE.kotl</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner">Koutliner</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-file_002c-func_002dmenu_002eel">file, func-menu.el</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-file_002c-hactypes_002eel">file, hactypes.el</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Creating-Types">Creating Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-file_002c-hactypes_002eel-1">file, hactypes.el</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Creating-Action-Types">Creating Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-file_002c-hbut_002eel">file, hbut.el</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Creating-Action-Types">Creating Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-file_002c-hbut_002eel-1">file, hbut.el</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Programmatic-Button-Creation">Programmatic Button Creation</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-file_002c-hib_002ddebbugs_002eel">file, hib-debbugs.el</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-file_002c-hib_002dkbd_002eel">file, hib-kbd.el</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Programmatic-Implicit-Button-Types">Programmatic Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-file_002c-hibtypes_002eel">file, hibtypes.el</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Buttons">Implicit Buttons</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-file_002c-hibtypes_002eel-1">file, hibtypes.el</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Creating-Types">Creating Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-file_002c-hmail_002eel">file, hmail.el</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Buttons-in-Mail">Buttons in Mail</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-file_002c-hmouse_002dkey_002eel">file, hmouse-key.el</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Questions-and-Answers">Questions and Answers</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-file_002c-hmouse_002dsh_002eel">file, hmouse-sh.el</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Questions-and-Answers">Questions and Answers</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-file_002c-hsettings_002eel">file, hsettings.el</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Button-Colors">Button Colors</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-file_002c-hsys_002d_002a">file, hsys-*</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Encapsulating-Systems">Encapsulating Systems</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-file_002c-hui_002dep_002a_002eel">file, hui-ep*.el</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Button-Colors">Button Colors</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-file_002c-hui_002dwindow_002eel">file, hui-window.el</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Questions-and-Answers">Questions and Answers</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-file_002c-HYPB">file, HYPB</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-file_002c-hyperbole_002eel">file, hyperbole.el</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Renaming">Renaming</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-file_002c-hyperbole_002eel-1">file, hyperbole.el</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Buttons-in-News">Buttons in News</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-file_002c-hyperbole_002eel-2">file, hyperbole.el</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-file_002c-hywconfig_002eel">file, hywconfig.el</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Window-Configurations">Window Configurations</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-file_002c-man_002fhyperbole_002ehtml">file, man/hyperbole.html</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Invocation">Invocation</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-file_002c-man_002fhyperbole_002einfo">file, man/hyperbole.info</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Invocation">Invocation</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-file_002c-man_002fhyperbole_002epdf">file, man/hyperbole.pdf</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Invocation">Invocation</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-file_002c-man_002fhyperbole_002etexi">file, man/hyperbole.texi</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Invocation">Invocation</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-file_002c-MANIFEST">file, MANIFEST</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-fill_002dcolumn">fill-column</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-fill_002dprefix">fill-prefix</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Button-Label-Normalization">Button Label Normalization</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-find_002dfile"><code>find-file</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Using-URLs-with-Find_002dFile">Using URLs with Find-File</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-find_002dfile_002dhook">find-file-hook</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hook-Variables">Hook Variables</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Function_fn_letter-G">G</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-gbut_003afile">gbut:file</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Glossary">Glossary</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Function_fn_letter-H">H</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-hbmap_003adir_002duser">hbmap:dir-user</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Button-Files">Button Files</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hbmap_003afilename">hbmap:filename</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Button-Files">Button Files</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hbut_003acurrent">hbut:current</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hook-Variables">Hook Variables</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hbut_003acurrent-1">hbut:current</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Operational-and-Storage-Formats">Operational and Storage Formats</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hbut_003afill_002dprefix_002dregexps">hbut:fill-prefix-regexps</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Button-Label-Normalization">Button Label Normalization</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hbut_003alabel_002dto_002dkey">hbut:label-to-key</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Button-Label-Normalization">Button Label Normalization</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hbut_003amax_002dlen-1">hbut:max-len</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Glossary">Glossary</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hbut_003amax_002dlen"><code>hbut:max-len</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Glossary">Glossary</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hibtypes_002dbegin_002dload_002dhook">hibtypes-begin-load-hook</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hook-Variables">Hook Variables</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hibtypes_002dend_002dload_002dhook">hibtypes-end-load-hook</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hook-Variables">Hook Variables</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hibtypes_002dgit_002ddefault_002dproject">hibtypes-git-default-project</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hibtypes_002dgit_002ddefault_002dproject-1">hibtypes-git-default-project</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hibtypes_002dgithub_002ddefault_002dproject">hibtypes-github-default-project</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hibtypes_002dgithub_002ddefault_002duser">hibtypes-github-default-user</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hibtypes_002dgithub_002ddefault_002duser-1">hibtypes-github-default-user</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hibtypes_002dgitlab_002ddefault_002dproject">hibtypes-gitlab-default-project</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hibtypes_002dgitlab_002ddefault_002duser">hibtypes-gitlab-default-user</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hibtypes_002dgitlab_002ddefault_002duser-1">hibtypes-gitlab-default-user</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hibtypes_002dsocial_002ddefault_002dservice">hibtypes-social-default-service</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hkey_002dace_002dwindow_002dsetup"><code>hkey-ace-window-setup</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Keyboard-Drags">Keyboard Drags</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hkey_002dalist">hkey-alist</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Questions-and-Answers">Questions and Answers</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hkey_002dalways_002ddisplay_002dmenu">hkey-always-display-menu</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Smart-Menus">Smart Key - Smart Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hkey_002deither"><code>hkey-either</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Bindings">Smart Key Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hkey_002dinit">hkey-init</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Default-Global-Bindings">Default Global Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hkey_002dinit_002doverride_002dlocal_002dkeys">hkey-init-override-local-keys</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Default-Global-Bindings">Default Global Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hkey_002doperate"><code>hkey-operate</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Keyboard-Drags">Keyboard Drags</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hkey_002dsummarize"><code>hkey-summarize</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Default-Context">Smart Key - Default Context</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hmail_003alister">hmail:lister</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Email-Readers">Smart Key - Email Readers</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hmail_003areader">hmail:reader</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Email-Readers">Smart Key - Email Readers</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hmouse_002dadd_002dunshifted_002dsmart_002dkeys"><code>hmouse-add-unshifted-smart-keys</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Bindings">Smart Key Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hmouse_002dalist">hmouse-alist</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Questions-and-Answers">Questions and Answers</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hmouse_002dcontext_002dibuffer_002dmenu"><code>hmouse-context-ibuffer-menu</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Mouse-Key-Modeline-Clicks">Smart Mouse Key Modeline Clicks</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hmouse_002dcontext_002dmenu"><code>hmouse-context-menu</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Mouse-Key-Modeline-Clicks">Smart Mouse Key Modeline Clicks</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hmouse_002ddrag_002ditem_002dmode_002dforms">hmouse-drag-item-mode-forms</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Mouse-Drags-outside-a-Window">Smart Mouse Drags outside a Window</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hmouse_002dget_002dbindings"><code>hmouse-get-bindings</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Questions-and-Answers">Questions and Answers</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hmouse_002dget_002dbindings-1"><code>hmouse-get-bindings</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Questions-and-Answers">Questions and Answers</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hmouse_002dmiddle_002dflag">hmouse-middle-flag</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Keys">Smart Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hmouse_002dmiddle_002dflag-1">hmouse-middle-flag</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Bindings">Smart Key Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hmouse_002dsetup"><code>hmouse-setup</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Questions-and-Answers">Questions and Answers</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hmouse_002dsetup-1"><code>hmouse-setup</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Questions-and-Answers">Questions and Answers</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hmouse_002dtoggle_002dbindings"><code>hmouse-toggle-bindings</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Default-Global-Bindings">Default Global Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hmouse_002dx_002ddiagonal_002dsensitivity">hmouse-x-diagonal-sensitivity</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Mouse-Drags-within-a-Window">Smart Mouse Drags within a Window</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hmouse_002dx_002ddrag_002dsensitivity">hmouse-x-drag-sensitivity</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Mouse-Drags-within-a-Window">Smart Mouse Drags within a Window</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hmouse_002dy_002ddiagonal_002dsensitivity">hmouse-y-diagonal-sensitivity</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Mouse-Drags-within-a-Window">Smart Mouse Drags within a Window</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hmouse_002dy_002ddrag_002dsensitivity">hmouse-y-drag-sensitivity</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Mouse-Drags-within-a-Window">Smart Mouse Drags within a Window</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hpath_003aat_002dp"><code>hpath:at-p</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hpath_003adisplay_002dwhere">hpath:display-where</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Action-Types">Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hpath_003adisplay_002dwhere-1">hpath:display-where</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Referent-Display">Referent Display</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hpath_003adisplay_002dwhere-2">hpath:display-where</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Internal-Viewers">Internal Viewers</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hpath_003aexternal_002ddisplay_002dalist">hpath:external-display-alist</a>:</td><td>&nbsp;</td><td valign="top"><a href="#External-Viewers">External Viewers</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hpath_003aexternal_002ddisplay_002dalist_002dmacos">hpath:external-display-alist-macos</a>:</td><td>&nbsp;</td><td valign="top"><a href="#External-Viewers">External Viewers</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hpath_003aexternal_002ddisplay_002dalist_002dmswindows">hpath:external-display-alist-mswindows</a>:</td><td>&nbsp;</td><td valign="top"><a href="#External-Viewers">External Viewers</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hpath_003aexternal_002ddisplay_002dalist_002dx">hpath:external-display-alist-x</a>:</td><td>&nbsp;</td><td valign="top"><a href="#External-Viewers">External Viewers</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hpath_003afind"><code>hpath:find</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hpath_003afind_002dfile_002durls_002dmode"><code>hpath:find-file-urls-mode</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Using-URLs-with-Find_002dFile">Using URLs with Find-File</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hpath_003aget_002dexternal_002ddisplay_002dalist"><code>hpath:get-external-display-alist</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#External-Viewers">External Viewers</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hpath_003ainternal_002ddisplay_002dalist">hpath:internal-display-alist</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Internal-Viewers">Internal Viewers</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hpath_003ainternal_002ddisplay_002dalist-1">hpath:internal-display-alist</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Internal-Viewers">Internal Viewers</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hpath_003anative_002dimage_002dsuffixes">hpath:native-image-suffixes</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Internal-Viewers">Internal Viewers</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hpath_003asuffixes">hpath:suffixes</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hpath_003avariables">hpath:variables</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Link-Variable-Substitution">Link Variable Substitution</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hproperty_003abut_002dcreate"><code>hproperty:but-create</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Button-Colors">Button Colors</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hproperty_003abut_002demphasize_002dflag">hproperty:but-emphasize-flag</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Button-Colors">Button Colors</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hproperty_003abut_002dhighlight_002dflag">hproperty:but-highlight-flag</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Button-Colors">Button Colors</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hproperty_003acycle_002dbut_002dcolor"><code>hproperty:cycle-but-color</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Button-Colors">Button Colors</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-htype_002dcreate_002dhook">htype-create-hook</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hook-Variables">Hook Variables</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-htype_002ddelete_002dhook">htype-delete-hook</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hook-Variables">Hook Variables</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hui_002dmenu_002dscreen_002dcommands"><code>hui-menu-screen-commands</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Mouse-Key-Modeline-Clicks">Smart Mouse Key Modeline Clicks</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hui_002dselect_002dgoto_002dmatching_002dtag"><code>hui-select-goto-matching-tag</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Thing-Selection">Smart Key Thing Selection</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hui_002dselect_002dthing"><code>hui-select-thing</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Thing-Selection">Smart Key Thing Selection</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hui_002dselect_002dthing_002dwith_002dmouse"><code>hui-select-thing-with-mouse</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Thing-Selection">Smart Key Thing Selection</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hui_003aebut_002dprompt_002dfor_002daction">hui:ebut-prompt-for-action</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Action-Types">Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hui_003aebut_002drename"><code>hui:ebut-rename</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Renaming">Renaming</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hui_003ahbut_002ddelete_002dconfirm_002dflag">hui:hbut-delete-confirm-flag</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Deletion">Deletion</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hycontrol_002ddisplay_002dbuffer_002dpredicate_002dlist">hycontrol-display-buffer-predicate-list</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hycontrol_002denable_002d_002dwindows_002dmode"><code>hycontrol-enable--windows-mode</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hycontrol_002denable_002dframes_002dmode"><code>hycontrol-enable-frames-mode</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hycontrol_002dframe_002dheights">hycontrol-frame-heights</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hycontrol_002dframe_002doffset">hycontrol-frame-offset</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hycontrol_002dframe_002doffset-1">hycontrol-frame-offset</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hycontrol_002dframe_002dwidths">hycontrol-frame-widths</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hycontrol_002dget_002dscreen_002doffsets"><code>hycontrol-get-screen-offsets</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hycontrol_002dkeep_002dwindow_002dflag">hycontrol-keep-window-flag</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hycontrol_002dkeep_002dwindow_002dflag-1">hycontrol-keep-window-flag</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Mouse-Drags-outside-a-Window">Smart Mouse Drags outside a Window</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hycontrol_002dscreen_002doffset_002dalist">hycontrol-screen-offset-alist</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hycontrol_002dset_002dscreen_002doffsets"><code>hycontrol-set-screen-offsets</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hypb_003argrep_002dcommand">hypb:rgrep-command</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hyperb_003adir">hyperb:dir</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Invocation">Invocation</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hyperbole"><code>hyperbole</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Invocation">Invocation</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hyperbole-1"><code>hyperbole</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Default-Context">Smart Key - Default Context</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hyperbole_002dinit_002dhook">hyperbole-init-hook</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hook-Variables">Hook Variables</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hyperbole_002dpopup_002dmenu"><code>hyperbole-popup-menu</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hyperbole_002dpopup_002dmenu-1"><code>hyperbole-popup-menu</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Default-Context">Smart Key - Default Context</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hyperbole_002dset_002dkey"><code>hyperbole-set-key</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Binding-Minibuffer-Menu-Items">Binding Minibuffer Menu Items</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hyperbole_002dtoggle_002dbindings"><code>hyperbole-toggle-bindings</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Bindings">Smart Key Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hyperbole_002dtoggle_002dbindings-1"><code>hyperbole-toggle-bindings</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Default-Global-Bindings">Default Global Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hyperbole_002dweb_002dsearch_002dalist">hyperbole-web-search-alist</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Web-Search-Engines">Web Search Engines</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hyperbole_002dweb_002dsearch_002dbrowser_002dfunction">hyperbole-web-search-browser-function</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hyrolo_002dadd"><code>hyrolo-add</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Menu">HyRolo Menu</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hyrolo_002dadd_002dhook">hyrolo-add-hook</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Keys">HyRolo Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hyrolo_002dadd_002dhook-1">hyrolo-add-hook</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hook-Variables">Hook Variables</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hyrolo_002ddisplay_002dformat_002dfunction">hyrolo-display-format-function</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Settings">HyRolo Settings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hyrolo_002ddisplay_002dhook">hyrolo-display-hook</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hook-Variables">Hook Variables</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hyrolo_002ddisplay_002dmatches"><code>hyrolo-display-matches</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Menu">HyRolo Menu</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hyrolo_002dedit"><code>hyrolo-edit</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Menu">HyRolo Menu</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hyrolo_002dedit_002dhook">hyrolo-edit-hook</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Keys">HyRolo Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hyrolo_002dedit_002dhook-1">hyrolo-edit-hook</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hook-Variables">Hook Variables</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hyrolo_002demail_002dformat">hyrolo-email-format</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Settings">HyRolo Settings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hyrolo_002dentry_002dregexp">hyrolo-entry-regexp</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Settings">HyRolo Settings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hyrolo_002dfgrep"><code>hyrolo-fgrep</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Menu">HyRolo Menu</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hyrolo_002dfile_002dlist">hyrolo-file-list</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Settings">HyRolo Settings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hyrolo_002dgoogle_002dcontacts_002dfgrep"><code>hyrolo-google-contacts-fgrep</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Settings">HyRolo Settings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hyrolo_002dgoogle_002dcontacts_002dflag">hyrolo-google-contacts-flag</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Settings">HyRolo Settings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hyrolo_002dgoogle_002dcontacts_002dgrep"><code>hyrolo-google-contacts-grep</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Settings">HyRolo Settings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hyrolo_002dgrep"><code>hyrolo-grep</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Menu">HyRolo Menu</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hyrolo_002dhdr_002dregexp">hyrolo-hdr-regexp</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Settings">HyRolo Settings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hyrolo_002dhighlight_002dface">hyrolo-highlight-face</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Settings">HyRolo Settings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hyrolo_002dkill"><code>hyrolo-kill</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Menu">HyRolo Menu</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hyrolo_002dkill_002dbuffers_002dafter_002duse">hyrolo-kill-buffers-after-use</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Settings">HyRolo Settings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hyrolo_002dmail_002dto"><code>hyrolo-mail-to</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Menu">HyRolo Menu</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hyrolo_002dmode_002dhook">hyrolo-mode-hook</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hook-Variables">Hook Variables</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hyrolo_002dsave_002dbuffers_002dafter_002duse">hyrolo-save-buffers-after-use</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Settings">HyRolo Settings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hyrolo_002dsort"><code>hyrolo-sort</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Menu">HyRolo Menu</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hyrolo_002dword"><code>hyrolo-word</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Menu">HyRolo Menu</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hyrolo_002dyank"><code>hyrolo-yank</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Menu">HyRolo Menu</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hyrolo_002dyank_002dreformat_002dfunction">hyrolo-yank-reformat-function</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hook-Variables">Hook Variables</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hywconfig_002dadd_002dby_002dname"><code>hywconfig-add-by-name</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Window-Configurations">Window Configurations</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hywconfig_002ddelete_002dby_002dname"><code>hywconfig-delete-by-name</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Window-Configurations">Window Configurations</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hywconfig_002ddelete_002dpop"><code>hywconfig-delete-pop</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Window-Configurations">Window Configurations</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hywconfig_002ddelete_002dpop-1"><code>hywconfig-delete-pop</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Window-Configurations">Window Configurations</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hywconfig_002drestore_002dby_002dname"><code>hywconfig-restore-by-name</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Window-Configurations">Window Configurations</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hywconfig_002dring_002dmax">hywconfig-ring-max</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Window-Configurations">Window Configurations</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hywconfig_002dring_002dsave"><code>hywconfig-ring-save</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Window-Configurations">Window Configurations</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hywconfig_002dring_002dsave-1"><code>hywconfig-ring-save</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Window-Configurations">Window Configurations</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hywconfig_002dyank_002dpop"><code>hywconfig-yank-pop</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Window-Configurations">Window Configurations</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hywconfig_002dyank_002dpop-1"><code>hywconfig-yank-pop</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Window-Configurations">Window Configurations</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Function_fn_letter-I">I</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-ibtype_003acreate"><code>ibtype:create</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Programmatic-Implicit-Button-Types">Programmatic Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ibtype_003adelete"><code>ibtype:delete</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Programmatic-Implicit-Button-Types">Programmatic Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ibtypes-actions"><code>ibtypes actions</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ibtypes-annot_002dbib"><code>ibtypes annot-bib</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ibtypes-completion"><code>ibtypes completion</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ibtypes-cscope"><code>ibtypes cscope</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ibtypes-ctags"><code>ibtypes ctags</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ibtypes-debbugs_002dgnu_002dmode"><code>ibtypes debbugs-gnu-mode</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ibtypes-debbugs_002dgnu_002dquery"><code>ibtypes debbugs-gnu-query</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ibtypes-debugger_002dsource"><code>ibtypes debugger-source</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ibtypes-dir_002dsummary"><code>ibtypes dir-summary</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ibtypes-doc_002did"><code>ibtypes doc-id</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ibtypes-elink"><code>ibtypes elink</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ibtypes-elisp_002dcompiler_002dmsg"><code>ibtypes elisp-compiler-msg</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ibtypes-etags"><code>ibtypes etags</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ibtypes-function_002din_002dbuffer"><code>ibtypes function-in-buffer</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ibtypes-git_002dcommit_002dreference"><code>ibtypes git-commit-reference</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ibtypes-git_002dreference"><code>ibtypes git-reference</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ibtypes-github_002dreference"><code>ibtypes github-reference</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ibtypes-gitlab_002dreference"><code>ibtypes gitlab-reference</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ibtypes-glink"><code>ibtypes glink</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ibtypes-gnus_002dpush_002dbutton"><code>ibtypes gnus-push-button</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ibtypes-grep_002dmsg"><code>ibtypes grep-msg</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ibtypes-hyp_002daddress"><code>ibtypes hyp-address</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ibtypes-hyp_002dsource"><code>ibtypes hyp-source</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ibtypes-id_002dcflow"><code>ibtypes id-cflow</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ibtypes-ilink"><code>ibtypes ilink</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ibtypes-Info_002dnode"><code>ibtypes Info-node</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ibtypes-ipython_002dstack_002dframe"><code>ibtypes ipython-stack-frame</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ibtypes-kbd_002dkey"><code>ibtypes kbd-key</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ibtypes-klink"><code>ibtypes klink</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ibtypes-mail_002daddress"><code>ibtypes mail-address</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ibtypes-man_002dapropos"><code>ibtypes man-apropos</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ibtypes-markdown_002dinternal_002dlink"><code>ibtypes markdown-internal-link</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ibtypes-org_002dmode"><code>ibtypes org-mode</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ibtypes-patch_002dmsg"><code>ibtypes patch-msg</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ibtypes-pathname"><code>ibtypes pathname</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ibtypes-pathname_002dline_002dand_002dcolumn"><code>ibtypes pathname-line-and-column</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ibtypes-rfc"><code>ibtypes rfc</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ibtypes-rfc_002dtoc"><code>ibtypes rfc-toc</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ibtypes-ripgrep_002dmsg"><code>ibtypes ripgrep-msg</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ibtypes-social_002dreference"><code>ibtypes social-reference</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ibtypes-texinfo_002dref"><code>ibtypes texinfo-ref</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ibtypes-text_002dtoc"><code>ibtypes text-toc</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ibtypes-www_002durl"><code>ibtypes www-url</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ibut_003aat_002dp"><code>ibut:at-p</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Programmatic-Implicit-Button-Types">Programmatic Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-image_002ddired_002dexternal_002dviewer">image-dired-external-viewer</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Image-Thumbnails">Smart Key - Image Thumbnails</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Info_002ddirectory_002dlist">Info-directory-list</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Invocation">Invocation</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Info_002dglobal_002dnext"><code>Info-global-next</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Info-Manuals">Smart Key - Info Manuals</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Info_002dglobal_002dprev"><code>Info-global-prev</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Info-Manuals">Smart Key - Info Manuals</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-inhibit_002dhsys_002dorg">inhibit-hsys-org</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-inhibit_002dhsys_002dorg-1">inhibit-hsys-org</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Questions-and-Answers">Questions and Answers</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-interactive"><code>interactive</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Creating-Action-Types">Creating Action Types</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Function_fn_letter-K">K</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-kcell_003aref_002dto_002did"><code>kcell:ref-to-id</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Action-Types">Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kexport_003ahtml"><code>kexport:html</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Exporting">Exporting</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kfile_003afind"><code>kfile:find</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menu-Commands">Menu Commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kfile_003awrite"><code>kfile:write</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kill_002dring">kill-ring</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Window-Configurations">Window Configurations</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kimport_003aaug_002dpost_002doutline"><code>kimport:aug-post-outline</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Inserting-and-Importing">Inserting and Importing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kimport_003afile"><code>kimport:file</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Inserting-and-Importing">Inserting and Importing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kimport_003ainsert_002dfile"><code>kimport:insert-file</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kimport_003ainsert_002dfile_002dcontents"><code>kimport:insert-file-contents</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Inserting-and-Importing">Inserting and Importing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kimport_003ainsert_002dregister"><code>kimport:insert-register</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kimport_003amode_002dalist">kimport:mode-alist</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Inserting-and-Importing">Inserting and Importing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kimport_003astar_002doutline"><code>kimport:star-outline</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Inserting-and-Importing">Inserting and Importing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kimport_003asuffix_002dalist">kimport:suffix-alist</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Inserting-and-Importing">Inserting and Importing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kimport_003atext"><code>kimport:text</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Inserting-and-Importing">Inserting and Importing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-klink_003acreate"><code>klink:create</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menu-Commands">Menu Commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-klink_003acreate-1"><code>klink:create</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode"><code>kotl-mode</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Inserting-and-Importing">Inserting and Importing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode-1"><code>kotl-mode</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Inserting-and-Importing">Inserting and Importing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_002dhook">kotl-mode-hook</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hook-Variables">Hook Variables</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003aadd_002dcell"><code>kotl-mode:add-cell</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003aadd_002dchild"><code>kotl-mode:add-child</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003aadd_002dparent"><code>kotl-mode:add-parent</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003aappend_002dcell"><code>kotl-mode:append-cell</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003aback_002dto_002dindentation"><code>kotl-mode:back-to-indentation</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003abackward_002dcell"><code>kotl-mode:backward-cell</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003abackward_002dchar"><code>kotl-mode:backward-char</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003abackward_002dkill_002dword"><code>kotl-mode:backward-kill-word</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003abackward_002dsentence"><code>kotl-mode:backward-sentence</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003abackward_002dword"><code>kotl-mode:backward-word</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003abeginning_002dof_002dbuffer"><code>kotl-mode:beginning-of-buffer</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003abeginning_002dof_002dcell"><code>kotl-mode:beginning-of-cell</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003abeginning_002dof_002dline"><code>kotl-mode:beginning-of-line</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003abeginning_002dof_002dtree"><code>kotl-mode:beginning-of-tree</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003acell_002dattributes"><code>kotl-mode:cell-attributes</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003acell_002dhelp"><code>kotl-mode:cell-help</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003acenter_002dline"><code>kotl-mode:center-line</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003acenter_002dparagraph"><code>kotl-mode:center-paragraph</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003acopy_002dafter"><code>kotl-mode:copy-after</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003acopy_002dbefore"><code>kotl-mode:copy-before</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003acopy_002dto_002dbuffer"><code>kotl-mode:copy-to-buffer</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003acopy_002dto_002dregister"><code>kotl-mode:copy-to-register</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003adelete_002dbackward_002dchar"><code>kotl-mode:delete-backward-char</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003adelete_002dblank_002dlines"><code>kotl-mode:delete-blank-lines</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003adelete_002dchar"><code>kotl-mode:delete-char</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003adelete_002dindentation"><code>kotl-mode:delete-indentation</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003ademote_002dtree"><code>kotl-mode:demote-tree</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003adown_002dlevel"><code>kotl-mode:down-level</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003aend_002dof_002dbuffer"><code>kotl-mode:end-of-buffer</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003aend_002dof_002dcell"><code>kotl-mode:end-of-cell</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003aend_002dof_002dline"><code>kotl-mode:end-of-line</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003aend_002dof_002dtree"><code>kotl-mode:end-of-tree</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003aexample"><code>kotl-mode:example</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003aexchange_002dcells"><code>kotl-mode:exchange-cells</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003afill_002dcell"><code>kotl-mode:fill-cell</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003afill_002dparagraph"><code>kotl-mode:fill-paragraph</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003afill_002dtree"><code>kotl-mode:fill-tree</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003afirst_002dsibling"><code>kotl-mode:first-sibling</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003afkey_002dbackward_002dchar"><code>kotl-mode:fkey-backward-char</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003afkey_002dforward_002dchar"><code>kotl-mode:fkey-forward-char</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003afkey_002dnext_002dline"><code>kotl-mode:fkey-next-line</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003afkey_002dprevious_002dline"><code>kotl-mode:fkey-previous-line</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003aforward_002dcell"><code>kotl-mode:forward-cell</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003aforward_002dchar"><code>kotl-mode:forward-char</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003aforward_002dpara"><code>kotl-mode:forward-para</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003aforward_002dparagraph"><code>kotl-mode:forward-paragraph</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003aforward_002dsentence"><code>kotl-mode:forward-sentence</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003aforward_002dword"><code>kotl-mode:forward-word</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003agoto_002dcell"><code>kotl-mode:goto-cell</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003ahide_002dsublevels"><code>kotl-mode:hide-sublevels</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menu-Commands">Menu Commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003ahide_002dsublevels-1"><code>kotl-mode:hide-sublevels</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003ahide_002dsubtree"><code>kotl-mode:hide-subtree</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003ahide_002dtree"><code>kotl-mode:hide-tree</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menu-Commands">Menu Commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003ahide_002dtree-1"><code>kotl-mode:hide-tree</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003aindent_002dline"><code>kotl-mode:indent-line</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003aindent_002dregion"><code>kotl-mode:indent-region</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003aindent_002dtabs_002dmode">kotl-mode:indent-tabs-mode</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Relocating-and-Copying">Relocating and Copying</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003ajust_002done_002dspace"><code>kotl-mode:just-one-space</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003akill_002dcontents"><code>kotl-mode:kill-contents</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003akill_002dline"><code>kotl-mode:kill-line</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003akill_002dregion"><code>kotl-mode:kill-region</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003akill_002dring_002dsave"><code>kotl-mode:kill-ring-save</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003akill_002dsentence"><code>kotl-mode:kill-sentence</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003akill_002dtree"><code>kotl-mode:kill-tree</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menu-Commands">Menu Commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003akill_002dtree-1"><code>kotl-mode:kill-tree</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003akill_002dword"><code>kotl-mode:kill-word</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003alast_002dsibling"><code>kotl-mode:last-sibling</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003amail_002dtree"><code>kotl-mode:mail-tree</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003amove_002dafter"><code>kotl-mode:move-after</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003amove_002dbefore"><code>kotl-mode:move-before</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003anewline"><code>kotl-mode:newline</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003anext_002dcell"><code>kotl-mode:next-cell</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003anext_002dline"><code>kotl-mode:next-line</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003aopen_002dline"><code>kotl-mode:open-line</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003aoverview"><code>kotl-mode:overview</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menu-Commands">Menu Commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003aoverview-1"><code>kotl-mode:overview</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003aprevious_002dcell"><code>kotl-mode:previous-cell</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003aprevious_002dline"><code>kotl-mode:previous-line</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003apromote_002dtree"><code>kotl-mode:promote-tree</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003arefill_002dflag">kotl-mode:refill-flag</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Filling">Filling</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003ascroll_002ddown"><code>kotl-mode:scroll-down</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003ascroll_002dup"><code>kotl-mode:scroll-up</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003aset_002dcell_002dattribute"><code>kotl-mode:set-cell-attribute</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003aset_002dfill_002dprefix"><code>kotl-mode:set-fill-prefix</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003ashow_002dall"><code>kotl-mode:show-all</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menu-Commands">Menu Commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003ashow_002dall-1"><code>kotl-mode:show-all</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003ashow_002dsubtree"><code>kotl-mode:show-subtree</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003ashow_002dtree"><code>kotl-mode:show-tree</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menu-Commands">Menu Commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003ashow_002dtree-1"><code>kotl-mode:show-tree</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003asplit_002dcell"><code>kotl-mode:split-cell</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003atop_002dcells"><code>kotl-mode:top-cells</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menu-Commands">Menu Commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003atop_002dcells-1"><code>kotl-mode:top-cells</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003atranspose_002dcells"><code>kotl-mode:transpose-cells</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003atranspose_002dchars"><code>kotl-mode:transpose-chars</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003atranspose_002dlines"><code>kotl-mode:transpose-lines</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003atranspose_002dwords"><code>kotl-mode:transpose-words</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003aup_002dlevel"><code>kotl-mode:up-level</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003ayank"><code>kotl-mode:yank</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003ayank_002dpop"><code>kotl-mode:yank-pop</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kotl_002dmode_003azap_002dto_002dchar"><code>kotl-mode:zap-to-char</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kview_003adefault_002dlabel_002dseparator">kview:default-label-separator</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Autonumbering">Autonumbering</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kview_003adefault_002dlabel_002dtype">kview:default-label-type</a>:</td><td>&nbsp;</td><td valign="top"><a href="#View-Specs">View Specs</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kview_003aset_002dlabel_002dseparator"><code>kview:set-label-separator</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kview_003aset_002dlabel_002dtype"><code>kview:set-label-type</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kvspec_003aactivate"><code>kvspec:activate</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menu-Commands">Menu Commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kvspec_003aactivate-1"><code>kvspec:activate</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kvspec_003astring">kvspec:string</a>:</td><td>&nbsp;</td><td valign="top"><a href="#View-Specs">View Specs</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kvspec_003atoggle_002dblank_002dlines"><code>kvspec:toggle-blank-lines</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menu-Commands">Menu Commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kvspec_003atoggle_002dblank_002dlines-1"><code>kvspec:toggle-blank-lines</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Function_fn_letter-L">L</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-link_002dto_002dfile"><code>link-to-file</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Buttons">Implicit Buttons</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-locate_002dcommand">locate-command</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Function_fn_letter-M">M</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-mail"><code>mail</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Buttons-in-Mail">Buttons in Mail</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-mail_002dyank_002doriginal">mail-yank-original</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Buttons-in-Mail">Buttons in Mail</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Function_fn_letter-O">O</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-objc_002dcpp_002dinclude_002dpath">objc-cpp-include-path</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Objective_002dC-Source-Code">Smart Key - Objective-C Source Code</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-objc_002dinclude_002dpath">objc-include-path</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Objective_002dC-Source-Code">Smart Key - Objective-C Source Code</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-org_002dctrl_002dc_002dctrl_002dc"><code>org-ctrl-c-ctrl-c</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-org_002dmeta_002dreturn"><code>org-meta-return</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-outline_002dminor_002dmode-1"><code>outline-minor-mode</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Emacs-Outline-Mode">Smart Key - Emacs Outline Mode</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-outline_002dmode-1"><code>outline-mode</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Emacs-Outline-Mode">Smart Key - Emacs Outline Mode</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Function_fn_letter-R">R</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-run_002dhooks"><code>run-hooks</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Glossary">Glossary</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Function_fn_letter-S">S</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-selective_002ddisplay">selective-display</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Emacs-Outline-Mode">Smart Key - Emacs Outline Mode</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-smail_003acomment">smail:comment</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Buttons-in-Mail">Buttons in Mail</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-smart_002dasm_002dinclude_002dpath">smart-asm-include-path</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Assembly-Source-Code">Smart Key - Assembly Source Code</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-smart_002dc_002dcpp_002dinclude_002dpath">smart-c-cpp-include-path</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-C-Source-Code">Smart Key - C Source Code</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-smart_002dc_002dinclude_002dpath">smart-c-include-path</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-C-Source-Code">Smart Key - C Source Code</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-smart_002dc_002duse_002dlib_002dman">smart-c-use-lib-man</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-C-Source-Code">Smart Key - C Source Code</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-smart_002djava_002dpackage_002dpath">smart-java-package-path</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Java-Source-Code">Smart Key - Java Source Code</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-smart_002dman_002dc_002droutine_002dref">smart-man-c-routine-ref</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Man-Pages">Smart Key - Man Pages</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-smart_002dscroll_002dproportional">smart-scroll-proportional</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Smart-Scrolling">Smart Key - Smart Scrolling</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Function_fn_letter-W">W</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-write_002dfile_002dhooks">write-file-hooks</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hook-Variables">Hook Variables</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Function_fn_letter-Z">Z</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-zoom_002dfrm_002eel"><code>zoom-frm.el</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
</table>
<table><tr><th valign="top">Jump to: &nbsp; </th><td><a class="summary-letter" href="#Function_fn_letter-A"><b>A</b></a>
 &nbsp; 
<a class="summary-letter" href="#Function_fn_letter-B"><b>B</b></a>
 &nbsp; 
<a class="summary-letter" href="#Function_fn_letter-C"><b>C</b></a>
 &nbsp; 
<a class="summary-letter" href="#Function_fn_letter-D"><b>D</b></a>
 &nbsp; 
<a class="summary-letter" href="#Function_fn_letter-E"><b>E</b></a>
 &nbsp; 
<a class="summary-letter" href="#Function_fn_letter-F"><b>F</b></a>
 &nbsp; 
<a class="summary-letter" href="#Function_fn_letter-G"><b>G</b></a>
 &nbsp; 
<a class="summary-letter" href="#Function_fn_letter-H"><b>H</b></a>
 &nbsp; 
<a class="summary-letter" href="#Function_fn_letter-I"><b>I</b></a>
 &nbsp; 
<a class="summary-letter" href="#Function_fn_letter-K"><b>K</b></a>
 &nbsp; 
<a class="summary-letter" href="#Function_fn_letter-L"><b>L</b></a>
 &nbsp; 
<a class="summary-letter" href="#Function_fn_letter-M"><b>M</b></a>
 &nbsp; 
<a class="summary-letter" href="#Function_fn_letter-O"><b>O</b></a>
 &nbsp; 
<a class="summary-letter" href="#Function_fn_letter-R"><b>R</b></a>
 &nbsp; 
<a class="summary-letter" href="#Function_fn_letter-S"><b>S</b></a>
 &nbsp; 
<a class="summary-letter" href="#Function_fn_letter-W"><b>W</b></a>
 &nbsp; 
<a class="summary-letter" href="#Function_fn_letter-Z"><b>Z</b></a>
 &nbsp; 
</td></tr></table>

<hr>
<a name="Concept-Index"></a>
<div class="header">
<p>
Previous: <a href="#Function" accesskey="p" rel="prev">Function</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> &nbsp; [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Key-Index" title="Index" rel="index">Index</a>]</p>
</div>
<a name="Concept-Index-1"></a>
<h2 class="unnumbered">Concept Index</h2>

<table><tr><th valign="top">Jump to: &nbsp; </th><td><a class="summary-letter" href="#Concept-Index_cp_symbol-1"><b>&lt;</b></a>
 &nbsp; 
<a class="summary-letter" href="#Concept-Index_cp_symbol-2"><b>|</b></a>
 &nbsp; 
<br>
<a class="summary-letter" href="#Concept-Index_cp_letter-A"><b>A</b></a>
 &nbsp; 
<a class="summary-letter" href="#Concept-Index_cp_letter-B"><b>B</b></a>
 &nbsp; 
<a class="summary-letter" href="#Concept-Index_cp_letter-C"><b>C</b></a>
 &nbsp; 
<a class="summary-letter" href="#Concept-Index_cp_letter-D"><b>D</b></a>
 &nbsp; 
<a class="summary-letter" href="#Concept-Index_cp_letter-E"><b>E</b></a>
 &nbsp; 
<a class="summary-letter" href="#Concept-Index_cp_letter-F"><b>F</b></a>
 &nbsp; 
<a class="summary-letter" href="#Concept-Index_cp_letter-G"><b>G</b></a>
 &nbsp; 
<a class="summary-letter" href="#Concept-Index_cp_letter-H"><b>H</b></a>
 &nbsp; 
<a class="summary-letter" href="#Concept-Index_cp_letter-I"><b>I</b></a>
 &nbsp; 
<a class="summary-letter" href="#Concept-Index_cp_letter-J"><b>J</b></a>
 &nbsp; 
<a class="summary-letter" href="#Concept-Index_cp_letter-K"><b>K</b></a>
 &nbsp; 
<a class="summary-letter" href="#Concept-Index_cp_letter-L"><b>L</b></a>
 &nbsp; 
<a class="summary-letter" href="#Concept-Index_cp_letter-M"><b>M</b></a>
 &nbsp; 
<a class="summary-letter" href="#Concept-Index_cp_letter-N"><b>N</b></a>
 &nbsp; 
<a class="summary-letter" href="#Concept-Index_cp_letter-O"><b>O</b></a>
 &nbsp; 
<a class="summary-letter" href="#Concept-Index_cp_letter-P"><b>P</b></a>
 &nbsp; 
<a class="summary-letter" href="#Concept-Index_cp_letter-Q"><b>Q</b></a>
 &nbsp; 
<a class="summary-letter" href="#Concept-Index_cp_letter-R"><b>R</b></a>
 &nbsp; 
<a class="summary-letter" href="#Concept-Index_cp_letter-S"><b>S</b></a>
 &nbsp; 
<a class="summary-letter" href="#Concept-Index_cp_letter-T"><b>T</b></a>
 &nbsp; 
<a class="summary-letter" href="#Concept-Index_cp_letter-U"><b>U</b></a>
 &nbsp; 
<a class="summary-letter" href="#Concept-Index_cp_letter-V"><b>V</b></a>
 &nbsp; 
<a class="summary-letter" href="#Concept-Index_cp_letter-W"><b>W</b></a>
 &nbsp; 
<a class="summary-letter" href="#Concept-Index_cp_letter-X"><b>X</b></a>
 &nbsp; 
<a class="summary-letter" href="#Concept-Index_cp_letter-Y"><b>Y</b></a>
 &nbsp; 
<a class="summary-letter" href="#Concept-Index_cp_letter-Z"><b>Z</b></a>
 &nbsp; 
</td></tr></table>
<table class="index-cp" border="0">
<tr><td></td><th align="left">Index Entry</th><td>&nbsp;</td><th align="left"> Section</th></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Concept-Index_cp_symbol-1">&lt;</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-_003c_003e-delimiters">&lt;&gt; delimiters</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Links">Links</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_003c_0040-klink_003e">&lt;@ klink&gt;</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Links">Links</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_003c_007cviewspec_003e">&lt;|viewspec&gt;</a>:</td><td>&nbsp;</td><td valign="top"><a href="#View-Specs">View Specs</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Concept-Index_cp_symbol-2">|</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-_007c">|</a>:</td><td>&nbsp;</td><td valign="top"><a href="#View-Specs">View Specs</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Concept-Index_cp_letter-A">A</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-abbreviated-URLs">abbreviated URLs</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Using-URLs-with-Find_002dFile">Using URLs with Find-File</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ace_002dwindow">ace-window</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Keyboard-Drags">Keyboard Drags</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-action">action</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Action-Types">Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-action-1">action</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Action-Types">Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-action-button">action button</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Action-Buttons">Action Buttons</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-action-implicit-button">action implicit button</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Action-Key">Action Key</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Keys">Smart Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Action-Key-drag">Action Key drag</a>:</td><td>&nbsp;</td><td valign="top"><a href="#By-Dragging">By Dragging</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Action-Key_002c-cell-argument">Action Key, cell argument</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Relocating-and-Copying">Relocating and Copying</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Action-Key_002c-hide-or-show-cell">Action Key, hide or show cell</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hiding-and-Showing">Hiding and Showing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Action-Key_002c-klink">Action Key, klink</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Links">Links</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Action-Key_002c-web-browsing">Action Key, web browsing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Action-Mouse-Key">Action Mouse Key</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Thing-Selection">Thing Selection</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Action-Mouse-Key-1">Action Mouse Key</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Delimited-Things">Smart Key - Delimited Things</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Action-Mouse-Key-drag">Action Mouse Key drag</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Mouse-Key-Drags">Smart Mouse Key Drags</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-action-type">action type</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Action-Types">Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-action-type_002c-creation">action type, creation</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Creating-Action-Types">Creating Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-activating-implicit-button">activating implicit button</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Buttons">Implicit Buttons</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-activation">activation</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Operations">Smart Key Operations</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-active-region">active region</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Mouse-Drags-between-Windows">Smart Mouse Drags between Windows</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-active-region-1">active region</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Mouse-Drags-within-a-Window">Smart Mouse Drags within a Window</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-actype_002c-link_002dto_002dmail">actype, link-to-mail</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Buttons-in-Mail">Buttons in Mail</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-actypes_002c-list-of">actypes, list of</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Action-Types">Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-address">address</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-alpha-labels">alpha labels</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Autonumbering">Autonumbering</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-anonymous-ftp">anonymous ftp</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Top">Top</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-API">API</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Embedding-Hyperbole">Embedding Hyperbole</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-appending-to-a-cell">appending to a cell</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Splitting-and-Appending">Splitting and Appending</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-argument-entry">argument entry</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Argument-Selection">Smart Key Argument Selection</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-argument_002c-Info-index-item">argument, Info index item</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Creating-Action-Types">Creating Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-argument_002c-Info-node">argument, Info node</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Creating-Action-Types">Creating Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-argument_002c-kcell">argument, kcell</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Creating-Action-Types">Creating Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-argument_002c-klink">argument, klink</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Creating-Action-Types">Creating Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-argument_002c-koutline">argument, koutline</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Creating-Action-Types">Creating Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-argument_002c-mail-message">argument, mail message</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Creating-Action-Types">Creating Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-argument_002c-reading">argument, reading</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Creating-Action-Types">Creating Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-argument_002c-use">argument, use</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Action-Types">Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-argument_002c-view-spec">argument, view spec</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Creating-Action-Types">Creating Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-array">array</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Thing-Selection">Thing Selection</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-array-1">array</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Delimited-Things">Smart Key - Delimited Things</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Assist-Key">Assist Key</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Keys">Smart Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Assist-Key_002c-listing-attributes">Assist Key, listing attributes</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Cell-Attributes">Cell Attributes</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Assist-Mouse-Key">Assist Mouse Key</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Thing-Selection">Thing Selection</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Assist-Mouse-Key-1">Assist Mouse Key</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Delimited-Things">Smart Key - Delimited Things</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Assist-Mouse-Key-drag">Assist Mouse Key drag</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Mouse-Key-Drags">Smart Mouse Key Drags</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-attribute">attribute</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Cell-Attributes">Cell Attributes</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-attribute_002c-adding">attribute, adding</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Cell-Attributes">Cell Attributes</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-attribute_002c-modifying">attribute, modifying</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Cell-Attributes">Cell Attributes</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-attribute_002c-no_002dfill">attribute, no-fill</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Filling">Filling</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-attribute_002c-no_002dfill-1">attribute, no-fill</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Splitting-and-Appending">Splitting and Appending</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-attribute_002c-no_002dfill-2">attribute, no-fill</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Cell-Attributes">Cell Attributes</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-attribute_002c-removing">attribute, removing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Cell-Attributes">Cell Attributes</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Augment">Augment</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-History">Koutliner History</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Augment-1">Augment</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Glossary">Glossary</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Augment-outline">Augment outline</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Inserting-and-Importing">Inserting and Importing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-autonumber">autonumber</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner">Koutliner</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-autonumber-1">autonumber</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Autonumbering">Autonumbering</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Concept-Index_cp_letter-B">B</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-balance-windows">balance windows</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-BBDB">BBDB</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Settings">HyRolo Settings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-bibliography">bibliography</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Big-Brother-DataBase">Big Brother DataBase</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Settings">HyRolo Settings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-binding-keys">binding keys</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Binding-Minibuffer-Menu-Items">Binding Minibuffer Menu Items</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-blank-lines_002c-toggle">blank lines, toggle</a>:</td><td>&nbsp;</td><td valign="top"><a href="#View-Specs">View Specs</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-bookmarks">bookmarks</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Global-Buttons">Global Buttons</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-boolean-expressions">boolean expressions</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Buttons">Implicit Buttons</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-breakpoint">breakpoint</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-browsing-URLs">browsing URLs</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Using-URLs-with-Find_002dFile">Using URLs with Find-File</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-browsing-URLs-in-find_002dfile">browsing URLs in find-file</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Using-URLs-with-Find_002dFile">Using URLs with Find-File</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-buffer-id">buffer id</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Mouse-Key-Modeline-Clicks">Smart Mouse Key Modeline Clicks</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-buffer-menu">buffer menu</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Mouse-Key-Modeline-Clicks">Smart Mouse Key Modeline Clicks</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-buffer-menu-1">buffer menu</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Minibuffer-Menu-Activation">Minibuffer Menu Activation</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-buffer-menu-2">buffer menu</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Buffer-Menus">Smart Key - Buffer Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-buffer-menu-item-drag">buffer menu item drag</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Displaying-File-and-Buffer-Items">Displaying File and Buffer Items</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-buffer-replace">buffer replace</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Keyboard-Drags">Keyboard Drags</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-buffer_002c-bury">buffer, bury</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-buffer_002c-copy">buffer, copy</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Displaying-Buffers">Displaying Buffers</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-buffer_002c-swap">buffer, swap</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Swapping-Buffers">Swapping Buffers</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-buffer_002c-swap-1">buffer, swap</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-buffer_002c-unbury">buffer, unbury</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-buffers-swap">buffers swap</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Keyboard-Drags">Keyboard Drags</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-bug-tracking">bug tracking</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-bury-buffer">bury buffer</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Mouse-Key-Modeline-Clicks">Smart Mouse Key Modeline Clicks</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-burying">burying</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-button">button</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Buttons">Buttons</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-button-action">button action</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Action-Types">Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-button-activation">button activation</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Operations">Smart Key Operations</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-button-attribute">button attribute</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Explicit-Buttons">Explicit Buttons</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-button-attributes">button attributes</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Modification">Modification</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-button-attributes-1">button attributes</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Operational-and-Storage-Formats">Operational and Storage Formats</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-button-category">button category</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Buttons">Buttons</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-button-click">button click</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Hyperbole-Buttons">Smart Key - Hyperbole Buttons</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-button-creation">button creation</a>:</td><td>&nbsp;</td><td valign="top"><a href="#By-Dragging">By Dragging</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-button-data">button data</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Explicit-Buttons">Explicit Buttons</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-button-data-saving">button data saving</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hook-Variables">Hook Variables</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-button-deletion">button deletion</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Deletion">Deletion</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-button-demo">button demo</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hyperbole-Overview">Hyperbole Overview</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-button-emphasis">button emphasis</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Button-Colors">Button Colors</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-button-file_002c-directory">button file, directory</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Button-Files">Button Files</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-button-file_002c-HYPB">button file, HYPB</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-button-file_002c-personal">button file, personal</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Button-Files">Button Files</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-button-files">button files</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Button-Files">Button Files</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-button-flashing">button flashing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Button-Colors">Button Colors</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-button-help">button help</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Operations">Smart Key Operations</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-button-help-1">button help</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Searching-and-Summarizing">Searching and Summarizing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-button-highlighting">button highlighting</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hook-Variables">Hook Variables</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-button-highlighting-1">button highlighting</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Button-Colors">Button Colors</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-button-instance">button instance</a>:</td><td>&nbsp;</td><td valign="top"><a href="#By-Menu">By Menu</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-button-key">button key</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Button-Label-Normalization">Button Label Normalization</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-button-label">button label</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Explicit-Buttons">Explicit Buttons</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-button-label-1">button label</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Global-Buttons">Global Buttons</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-button-label-2">button label</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Button-Label-Normalization">Button Label Normalization</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-button-label-overlap">button label overlap</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Button-Type-Precedence">Button Type Precedence</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-button-mailing">button mailing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Buttons-in-Mail">Buttons in Mail</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-button-modification">button modification</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Modification">Modification</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-button-name">button name</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Explicit-Buttons">Explicit Buttons</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-button-posting">button posting</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Buttons-in-Mail">Buttons in Mail</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-button-posting-1">button posting</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Buttons-in-News">Buttons in News</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-button-precedence">button precedence</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Button-Type-Precedence">Button Type Precedence</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-button-renaming">button renaming</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Renaming">Renaming</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-button-searching">button searching</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Searching-and-Summarizing">Searching and Summarizing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-button-summary">button summary</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Searching-and-Summarizing">Searching and Summarizing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-button_002c-explicit">button, explicit</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Buttons">Buttons</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-button_002c-explicit-1">button, explicit</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Explicit-Buttons">Explicit Buttons</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-button_002c-global">button, global</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Buttons">Buttons</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-button_002c-global-1">button, global</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Global-Buttons">Global Buttons</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-button_002c-implicit">button, implicit</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Buttons">Buttons</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-button_002c-implicit-1">button, implicit</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Buttons">Implicit Buttons</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-button_002c-moving">button, moving</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Explicit-Buttons">Explicit Buttons</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-button_002c-multiple-lines">button, multiple lines</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Button-Label-Normalization">Button Label Normalization</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-button_002c-split-across-lines">button, split across lines</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Button-Label-Normalization">Button Label Normalization</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-byte-compiler-error">byte compiler error</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Concept-Index_cp_letter-C">C</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-C-call-tree">C call tree</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C-flow-graph">C flow graph</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002fC_002b_002b-call-trees">C/C++ call trees</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-C_002fC_002b_002b-cross_002dreference">C/C++ cross-reference</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-call-tree_002c-C">call tree, C</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-cell_002c-adding">cell, adding</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Adding-and-Killing">Adding and Killing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-cell_002c-appending">cell, appending</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Splitting-and-Appending">Splitting and Appending</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-cell_002c-attribute">cell, attribute</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Cell-Attributes">Cell Attributes</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-cell_002c-collapse">cell, collapse</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hiding-and-Showing">Hiding and Showing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-cell_002c-creating">cell, creating</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Adding-and-Killing">Adding and Killing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-cell_002c-creation-time">cell, creation time</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Cell-Attributes">Cell Attributes</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-cell_002c-exchanging">cell, exchanging</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Transposing">Transposing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-cell_002c-expand">cell, expand</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hiding-and-Showing">Hiding and Showing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-cell_002c-filling">cell, filling</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Filling">Filling</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-cell_002c-hide-subtree">cell, hide subtree</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hiding-and-Showing">Hiding and Showing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-cell_002c-hiding-levels">cell, hiding levels</a>:</td><td>&nbsp;</td><td valign="top"><a href="#View-Specs">View Specs</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-cell_002c-idstamp-0">cell, idstamp 0</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Creating-Outlines">Creating Outlines</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-cell_002c-idstamp-0-1">cell, idstamp 0</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Idstamps">Idstamps</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-cell_002c-killing">cell, killing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Adding-and-Killing">Adding and Killing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-cell_002c-label-separator">cell, label separator</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Autonumbering">Autonumbering</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-cell_002c-mark-and-point">cell, mark and point</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Transposing">Transposing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-cell_002c-no_002dfill-attribute">cell, no-fill attribute</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Filling">Filling</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-cell_002c-no_002dfill-attribute-1">cell, no-fill attribute</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Splitting-and-Appending">Splitting and Appending</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-cell_002c-no_002dfill-attribute-2">cell, no-fill attribute</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Cell-Attributes">Cell Attributes</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-cell_002c-selection">cell, selection</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Editing">Editing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-cell_002c-show-all">cell, show all</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hiding-and-Showing">Hiding and Showing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-cell_002c-show-levels">cell, show levels</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hiding-and-Showing">Hiding and Showing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-cell_002c-show-subtree">cell, show subtree</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hiding-and-Showing">Hiding and Showing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-cell_002c-splitting">cell, splitting</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Splitting-and-Appending">Splitting and Appending</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-cell_002c-top_002dlevel">cell, top-level</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Creating-Outlines">Creating Outlines</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-cell_002c-top_002dlevel-1">cell, top-level</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Idstamps">Idstamps</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-cell_002c-transposing">cell, transposing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Transposing">Transposing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-cell_002c-yanking-contents">cell, yanking contents</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Adding-and-Killing">Adding and Killing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-change-key-bindings">change key bindings</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Bindings">Smart Key Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-change-key-bindings-1">change key bindings</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Default-Global-Bindings">Default Global Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-change_002dlog_002dmode">change-log-mode</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Lisp-Source-Code">Smart Key - Lisp Source Code</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-changing-the-view-spec">changing the view spec</a>:</td><td>&nbsp;</td><td valign="top"><a href="#View-Specs">View Specs</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-click_002c-buffer-menu">click, buffer menu</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Buffer-Menus">Smart Key - Buffer Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-click_002c-button">click, button</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Hyperbole-Buttons">Smart Key - Hyperbole Buttons</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-click_002c-dired">click, dired</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Dired-Mode">Smart Key - Dired Mode</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-click_002c-end-of-line">click, end of line</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Smart-Scrolling">Smart Key - Smart Scrolling</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-click_002c-Gnus">click, Gnus</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-GNUS-Newsreader">Smart Key - GNUS Newsreader</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-click_002c-hyrolo-matches">click, hyrolo matches</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-HyRolo-Match-Buffers">Smart Key - HyRolo Match Buffers</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-click_002c-ibuffer-menu">click, ibuffer menu</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Buffer-Menus">Smart Key - Buffer Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-click_002c-Info">click, Info</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Info-Manuals">Smart Key - Info Manuals</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-click_002c-modeline">click, modeline</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Modeline-Clicks-and-Drags">Modeline Clicks and Drags</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-click_002c-tar">click, tar</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Tar-File-Mode">Smart Key - Tar File Mode</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-click_002c-world_002dwide-web">click, world-wide web</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-WWW-URLs">Smart Key - WWW URLs</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-clone-window">clone window</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Cloning-Windows">Cloning Windows</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-clone-window-1">clone window</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-clone-window-2">clone window</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Mouse-Drags-outside-a-Window">Smart Mouse Drags outside a Window</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-code-block">code block</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-code-block-selection">code block selection</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Thing-Selection">Smart Key Thing Selection</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-collaboration">collaboration</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-History">Koutliner History</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-collapse-lines">collapse lines</a>:</td><td>&nbsp;</td><td valign="top"><a href="#View-Specs">View Specs</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-collapsing">collapsing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hiding-and-Showing">Hiding and Showing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-comment">comment</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Thing-Selection">Thing Selection</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-comment-1">comment</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Delimited-Things">Smart Key - Delimited Things</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-company_002dmode">company-mode</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Company-Mode">Smart Key - Company Mode</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-compiler-error">compiler error</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-compiler-error-1">compiler error</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-completion">completion</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Argument-Selection">Smart Key Argument Selection</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-completion-1">completion</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-completion-2">completion</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Company-Mode">Smart Key - Company Mode</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-completion-3">completion</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Argument-Completion">Smart Key - Argument Completion</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-completion-4">completion</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Helm-Mode">Smart Key - Helm Mode</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-configuration">configuration</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Customization">Customization</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-contacts_002c-Google">contacts, Google</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Settings">HyRolo Settings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-context">context</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Buttons">Implicit Buttons</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-context_002dsensitive-help">context-sensitive help</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Operations">Smart Key Operations</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-copy-and-yank">copy and yank</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Thing-Selection">Thing Selection</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-copy-and-yank-1">copy and yank</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Mouse-Drags-between-Windows">Smart Mouse Drags between Windows</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-copy-and-yank-2">copy and yank</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Delimited-Things">Smart Key - Delimited Things</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-copy-buffer">copy buffer</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Displaying-Buffers">Displaying Buffers</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-copy-region">copy region</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Thing-Selection">Smart Key Thing Selection</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-copying">copying</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Relocating-and-Copying">Relocating and Copying</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-create-link-button">create link button</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Keyboard-Drags">Keyboard Drags</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-create_002dtime-attribute">create-time attribute</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Cell-Attributes">Cell Attributes</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-creating-buttons">creating buttons</a>:</td><td>&nbsp;</td><td valign="top"><a href="#By-Dragging">By Dragging</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-creating-links">creating links</a>:</td><td>&nbsp;</td><td valign="top"><a href="#By-Dragging">By Dragging</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-creator-attribute">creator attribute</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Cell-Attributes">Cell Attributes</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-credits">credits</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Top">Top</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-cross-referencing">cross referencing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-History">Koutliner History</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-cross_002dreference_002c-Texinfo">cross-reference, Texinfo</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Cscope">Cscope</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ctags-entry">ctags entry</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-customization">customization</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Customization">Customization</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-customization-1">customization</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Customization">Customization</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-customize">customize</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-customize_002c-rolo-additions">customize, rolo additions</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Keys">HyRolo Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-customize_002c-rolo-datestamps">customize, rolo datestamps</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Keys">HyRolo Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-customize_002c-rolo-edits">customize, rolo edits</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Keys">HyRolo Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-customizing-web-search-menu">customizing web search menu</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Web-Search-Engines">Web Search Engines</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-cut-region">cut region</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Thing-Selection">Smart Key Thing Selection</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-cutoff-lines">cutoff lines</a>:</td><td>&nbsp;</td><td valign="top"><a href="#View-Specs">View Specs</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Concept-Index_cp_letter-D">D</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-database">database</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-RDB-Mode">Smart Key - RDB Mode</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-datestamps">datestamps</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Keys">HyRolo Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-dbx">dbx</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-debugging-Smart-Keys">debugging Smart Keys</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Debugging">Smart Key Debugging</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-default-label-type">default label type</a>:</td><td>&nbsp;</td><td valign="top"><a href="#View-Specs">View Specs</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-default-Smart-Key-context">default Smart Key context</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Operations">Smart Key Operations</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-definitions">definitions</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Glossary">Glossary</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-delete-frame">delete frame</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-delimited-things">delimited things</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Thing-Selection">Smart Key Thing Selection</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-demo-file">demo file</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Manual-Overview">Manual Overview</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-demonstration">demonstration</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hyperbole-Overview">Hyperbole Overview</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-demotion">demotion</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Relocating-and-Copying">Relocating and Copying</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-diagonal-drag">diagonal drag</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Saving-and-Restoring-Window-Configurations">Saving and Restoring Window Configurations</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-diagonal-drag-1">diagonal drag</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Mouse-Drags-within-a-Window">Smart Mouse Drags within a Window</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-digital-signature">digital signature</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Glossary">Glossary</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-direct-link-creation">direct link creation</a>:</td><td>&nbsp;</td><td valign="top"><a href="#By-Dragging">By Dragging</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-direct-selection">direct selection</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Argument-Selection">Smart Key Argument Selection</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-directory-editor">directory editor</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Mouse-Key-Modeline-Clicks">Smart Mouse Key Modeline Clicks</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-dired">dired</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Mouse-Key-Modeline-Clicks">Smart Mouse Key Modeline Clicks</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-dired-browsing">dired browsing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Dired-Mode">Smart Key - Dired Mode</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-dired-item-drag">dired item drag</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Displaying-File-and-Buffer-Items">Displaying File and Buffer Items</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-dired_002c-images">dired, images</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Image-Thumbnails">Smart Key - Image Thumbnails</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-dired_002dsidebar_002dmode">dired-sidebar-mode</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Dired-Sidebar-Mode">Smart Key - Dired Sidebar Mode</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-disable-global-key-bindings">disable global key bindings</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Default-Global-Bindings">Default Global Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-disable-Hyperbole">disable Hyperbole</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Bindings">Smart Key Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-disable-Hyperbole-1">disable Hyperbole</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Default-Global-Bindings">Default Global Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-disable-local-key-override">disable local key override</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Default-Global-Bindings">Default Global Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-disable-org_002dmode-support">disable org-mode support</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-display">display</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-display-function">display function</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Internal-Viewers">Internal Viewers</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-display-outside-Emacs">display outside Emacs</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Referent-Display">Referent Display</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-display-where">display where</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Referent-Display">Referent Display</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-DisplayHere-mode">DisplayHere mode</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Dired-Mode">Smart Key - Dired Mode</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-distributed-collaboration">distributed collaboration</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-History">Koutliner History</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-document-identifier">document identifier</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-double-click">double click</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Argument-Selection">Smart Key Argument Selection</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-drag">drag</a>:</td><td>&nbsp;</td><td valign="top"><a href="#By-Dragging">By Dragging</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-drag-1">drag</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Thing-Selection">Thing Selection</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-drag-2">drag</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Delimited-Things">Smart Key - Delimited Things</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-drag-emulation">drag emulation</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Keyboard-Drags">Keyboard Drags</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-drag-item">drag item</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Keyboard-Drags">Keyboard Drags</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-drag_002c-buffer-menu-item">drag, buffer menu item</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Displaying-File-and-Buffer-Items">Displaying File and Buffer Items</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-drag_002c-buffer-swap">drag, buffer swap</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Swapping-Buffers">Swapping Buffers</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-drag_002c-clone-window">drag, clone window</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Cloning-Windows">Cloning Windows</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-drag_002c-copy-buffer">drag, copy buffer</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Displaying-Buffers">Displaying Buffers</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-drag_002c-diagonal">drag, diagonal</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Saving-and-Restoring-Window-Configurations">Saving and Restoring Window Configurations</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-drag_002c-diagonal-1">drag, diagonal</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Mouse-Drags-within-a-Window">Smart Mouse Drags within a Window</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-drag_002c-dired">drag, dired</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Dired-Mode">Smart Key - Dired Mode</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-drag_002c-dired-item">drag, dired item</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Displaying-File-and-Buffer-Items">Displaying File and Buffer Items</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-drag_002c-horizontal">drag, horizontal</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Creating-and-Deleting-Windows">Creating and Deleting Windows</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-drag_002c-horizontal-1">drag, horizontal</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Mouse-Drags-within-a-Window">Smart Mouse Drags within a Window</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-drag_002c-move-frame">drag, move frame</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Moving-Frames">Moving Frames</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-drag_002c-resize-window">drag, resize window</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Resizing-Windows">Resizing Windows</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-drag_002c-side-edge">drag, side edge</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Side_002dby_002dSide-Window-Resizing">Side-by-Side Window Resizing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-drag_002c-Smart-Mouse-Key">drag, Smart Mouse Key</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Mouse-Key-Drags">Smart Mouse Key Drags</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-drag_002c-Treemacs-item">drag, Treemacs item</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Displaying-File-and-Buffer-Items">Displaying File and Buffer Items</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-drag_002c-vertical">drag, vertical</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Creating-and-Deleting-Windows">Creating and Deleting Windows</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-drag_002c-vertical-1">drag, vertical</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Mouse-Drags-within-a-Window">Smart Mouse Drags within a Window</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-drag_002c-window-configuration">drag, window configuration</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Saving-and-Restoring-Window-Configurations">Saving and Restoring Window Configurations</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-drag_002c-with-region">drag, with region</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Thing-Selection">Smart Key Thing Selection</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-drag_002c-with-region-1">drag, with region</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Mouse-Drags-within-a-Window">Smart Mouse Drags within a Window</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-dragging-frames">dragging frames</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Moving-Frames">Moving Frames</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-dragging-items">dragging items</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Mouse-Drags-outside-a-Window">Smart Mouse Drags outside a Window</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-dragging-items_002c-buffer-menu">dragging items, buffer menu</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Mouse-Key-Modeline-Clicks">Smart Mouse Key Modeline Clicks</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-dragging-items_002c-dired">dragging items, dired</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Mouse-Key-Modeline-Clicks">Smart Mouse Key Modeline Clicks</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-dragging-outside-Emacs">dragging outside Emacs</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Mouse-Drags-outside-a-Window">Smart Mouse Drags outside a Window</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Concept-Index_cp_letter-E">E</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-e_002dmail-address">e-mail address</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-e_002dmail-address-1">e-mail address</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Cell-Attributes">Cell Attributes</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-elink">elink</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-elisp-identifier">elisp identifier</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Lisp-Source-Code">Smart Key - Lisp Source Code</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ellipses">ellipses</a>:</td><td>&nbsp;</td><td valign="top"><a href="#View-Specs">View Specs</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Emacs">Emacs</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hyperbole-Overview">Hyperbole Overview</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Emacs-1">Emacs</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Emacs-Lisp">Emacs Lisp</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hyperbole-Overview">Hyperbole Overview</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Emacs-Lisp-compiler-error">Emacs Lisp compiler error</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Emacs-Lisp-variables">Emacs Lisp variables</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Emacs-Lisp-variables-1">Emacs Lisp variables</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Link-Variable-Substitution">Link Variable Substitution</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-emacs-outline">emacs outline</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Inserting-and-Importing">Inserting and Importing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Emacs-support">Emacs support</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Button-Colors">Button Colors</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-emulation_002c-drag">emulation, drag</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Keyboard-Drags">Keyboard Drags</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-enabling-URLs-in-find_002dfile">enabling URLs in find-file</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Using-URLs-with-Find_002dFile">Using URLs with Find-File</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-end-of-line-click">end of line click</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Smart-Scrolling">Smart Key - Smart Scrolling</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Engelbart">Engelbart</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-History">Koutliner History</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Engelbart-1">Engelbart</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Glossary">Glossary</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-environment-variables">environment variables</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-environment-variables-1">environment variables</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Link-Variable-Substitution">Link Variable Substitution</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-equalize-windows">equalize windows</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-etags-entry">etags entry</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-exchanging-cells">exchanging cells</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Transposing">Transposing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-exit-HyControl">exit HyControl</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-expanding">expanding</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hiding-and-Showing">Hiding and Showing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-explicit-button">explicit button</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Buttons">Buttons</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-explicit-button-1">explicit button</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Explicit-Buttons">Explicit Buttons</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-explicit-button-creation">explicit button creation</a>:</td><td>&nbsp;</td><td valign="top"><a href="#By-Dragging">By Dragging</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-explicit-button-deletion">explicit button deletion</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Deletion">Deletion</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-explicit-button-formats">explicit button formats</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Operational-and-Storage-Formats">Operational and Storage Formats</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-explicit-button-link">explicit button link</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-explicit-button-modification">explicit button modification</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Modification">Modification</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-explicit-button-renaming">explicit button renaming</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Renaming">Renaming</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-explicit-button-searching">explicit button searching</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Searching-and-Summarizing">Searching and Summarizing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-explicit-button-storage">explicit button storage</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Operational-and-Storage-Formats">Operational and Storage Formats</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-explicit-button-summary">explicit button summary</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Searching-and-Summarizing">Searching and Summarizing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-explicit-button_002c-programmatic-creation">explicit button, programmatic creation</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Programmatic-Button-Creation">Programmatic Button Creation</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-exporting">exporting</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Exporting">Exporting</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-exporting-an-outline">exporting an outline</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Relocating-and-Copying">Relocating and Copying</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-external-display">external display</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Referent-Display">Referent Display</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-external-display-1">external display</a>:</td><td>&nbsp;</td><td valign="top"><a href="#External-Viewers">External Viewers</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-external-klink">external klink</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Links">Links</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-external-program">external program</a>:</td><td>&nbsp;</td><td valign="top"><a href="#External-Viewers">External Viewers</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-external-viewer">external viewer</a>:</td><td>&nbsp;</td><td valign="top"><a href="#External-Viewers">External Viewers</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-extracting-from-tar-files">extracting from tar files</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Tar-File-Mode">Smart Key - Tar File Mode</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Concept-Index_cp_letter-F">F</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-file-display-function">file display function</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Internal-Viewers">Internal Viewers</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-file-viewer_002c-Treemacs">file viewer, Treemacs</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Mouse-Key-Modeline-Clicks">Smart Mouse Key Modeline Clicks</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-file_002c-DEMO">file, DEMO</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Manual-Overview">Manual Overview</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-file_002c-hycontrol_002eel">file, hycontrol.el</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-file_002c-importing">file, importing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Inserting-and-Importing">Inserting and Importing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-filename">filename</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-fill-prefix">fill prefix</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Button-Label-Normalization">Button Label Normalization</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-filling">filling</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Filling">Filling</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-filling-1">filling</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Filling">Filling</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Find">Find</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-find_002dfile_002c-browsing-URLs">find-file, browsing URLs</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Using-URLs-with-Find_002dFile">Using URLs with Find-File</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-flashing-buttons">flashing buttons</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Button-Colors">Button Colors</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-frame-configuration">frame configuration</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-frame-relocate">frame relocate</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-frame-resize">frame resize</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-frame_002c-delete">frame, delete</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-frame_002c-lower">frame, lower</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-frame_002c-make">frame, make</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-frame_002c-maximize">frame, maximize</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-frame_002c-other">frame, other</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-frame_002c-percentage-resize">frame, percentage resize</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-frame_002c-raise">frame, raise</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-frame_002c-shrink">frame, shrink</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-frame_002c-to-edge">frame, to edge</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-frame_002c-zoom">frame, zoom</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-frames-control">frames control</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ftp">ftp</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ftp-1">ftp</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-func_002dmenu">func-menu</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-function">function</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Thing-Selection">Thing Selection</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-function-1">function</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Delimited-Things">Smart Key - Delimited Things</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-function-menu">function menu</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-functon-call-implicit-button">functon call implicit button</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Concept-Index_cp_letter-G">G</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-game_002c-gomoku">game, gomoku</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Gomoku-Game">Smart Key - Gomoku Game</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-gdb">gdb</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-git">git</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Magit-Mode">Smart Key - Magit Mode</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-git-commit-reference">git commit reference</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-git-reference">git reference</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-github-reference">github reference</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-gitlab-reference">gitlab reference</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-glink">glink</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-global-button">global button</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Buttons">Buttons</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-global-button-1">global button</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Global-Buttons">Global Buttons</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-global-button-2">global button</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Button-Files">Button Files</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-global-button-link">global button link</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-global-button_002c-modify">global button, modify</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Questions-and-Answers">Questions and Answers</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-glossary">glossary</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Glossary">Glossary</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Gmail-Contacts">Gmail Contacts</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Settings">HyRolo Settings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-GNU-Emacs">GNU Emacs</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hyperbole-Overview">Hyperbole Overview</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-GNU-Hyperbole">GNU Hyperbole</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hyperbole-Overview">Hyperbole Overview</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Gnus">Gnus</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Buttons-in-Mail">Buttons in Mail</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Gnus-1">Gnus</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Buttons-in-News">Buttons in News</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Gnus-browsing">Gnus browsing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-GNUS-Newsreader">Smart Key - GNUS Newsreader</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-GNUS-push_002dbuttons">GNUS push-buttons</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-gomoku">gomoku</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Gomoku-Game">Smart Key - Gomoku Game</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Google-Contacts">Google Contacts</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Settings">HyRolo Settings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-grep">grep</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-grep-1">grep</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Grep">Grep</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-grep-files">grep files</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-grid-of-windows">grid of windows</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-grid-of-windows-1">grid of windows</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Default-Global-Bindings">Default Global Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-groupware">groupware</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Glossary">Glossary</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Concept-Index_cp_letter-H">H</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-hashtag">hashtag</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-helm-mode">helm mode</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Helm-Mode">Smart Key - Helm Mode</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-help-buffer">help buffer</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Help-Buffers">Smart Key - Help Buffers</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-help_002c-button">help, button</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Operations">Smart Key Operations</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-help_002c-menu-items">help, menu items</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-help_002c-Smart-Key">help, Smart Key</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Operations">Smart Key Operations</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hide-levels">hide levels</a>:</td><td>&nbsp;</td><td valign="top"><a href="#View-Specs">View Specs</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hide-lines">hide lines</a>:</td><td>&nbsp;</td><td valign="top"><a href="#View-Specs">View Specs</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hide-subtree">hide subtree</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hiding-and-Showing">Hiding and Showing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hide-tree">hide tree</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hiding-and-Showing">Hiding and Showing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hiding">hiding</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hiding-and-Showing">Hiding and Showing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hiding-signatures">hiding signatures</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-highlighting-buttons">highlighting buttons</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Button-Colors">Button Colors</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-history">history</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hook-variables">hook variables</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hook-Variables">Hook Variables</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-horizontal-drag">horizontal drag</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Creating-and-Deleting-Windows">Creating and Deleting Windows</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-horizontal-drag-1">horizontal drag</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Mouse-Drags-within-a-Window">Smart Mouse Drags within a Window</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-HTML-conversion">HTML conversion</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Exporting">Exporting</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-HTML-tag-pair">HTML tag pair</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Thing-Selection">Smart Key Thing Selection</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-HyControl">HyControl</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-HyControl-corner-placement">HyControl corner placement</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-HyControl-edge-placement">HyControl edge placement</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-HyControl-exit">HyControl exit</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-HyControl-help">HyControl help</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-HyControl-quit">HyControl quit</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-HyControl-screen-edge-offsets">HyControl screen edge offsets</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-HyControl-switch-modes">HyControl switch modes</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-HyControl-toggle-modes">HyControl toggle modes</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-HyControl-windows-grid">HyControl windows grid</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Hyperbole">Hyperbole</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hyperbole-Overview">Hyperbole Overview</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Hyperbole-API">Hyperbole API</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Embedding-Hyperbole">Embedding Hyperbole</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Hyperbole-applications">Hyperbole applications</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hyperbole-Overview">Hyperbole Overview</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Hyperbole-data-model">Hyperbole data model</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Explicit-Buttons">Explicit Buttons</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Hyperbole-demo">Hyperbole demo</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Manual-Overview">Manual Overview</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Hyperbole-features">Hyperbole features</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hyperbole-Overview">Hyperbole Overview</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Hyperbole-help">Hyperbole help</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Argument-Selection">Smart Key Argument Selection</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Hyperbole-mail-comment">Hyperbole mail comment</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Buttons-in-Mail">Buttons in Mail</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Hyperbole-mail-list">Hyperbole mail list</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Hyperbole-main-menu">Hyperbole main menu</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Hyperbole-manual">Hyperbole manual</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Invocation">Invocation</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Hyperbole-menubar-menu">Hyperbole menubar menu</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hyperbole-popup-menu">hyperbole popup menu</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Hyperbole-pulldown-menu">Hyperbole pulldown menu</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Hyperbole-report">Hyperbole report</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Hyperbole-types">Hyperbole types</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Creating-Types">Creating Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Hyperbole-version">Hyperbole version</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Suggestion-or-Bug-Reporting">Suggestion or Bug Reporting</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Hyperbole_002c-embedding">Hyperbole, embedding</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Embedding-Hyperbole">Embedding Hyperbole</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Hyperbole_002c-obtaining">Hyperbole, obtaining</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Top">Top</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Hyperbole_002c-obtaining-1">Hyperbole, obtaining</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Installation">Installation</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Hyperbole_002c-starting">Hyperbole, starting</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Hyperbole_002c-system-encapsulation">Hyperbole, system encapsulation</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Encapsulating-Systems">Encapsulating Systems</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hyperlink">hyperlink</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Links">Links</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hyperlink-anchor">hyperlink anchor</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner">Koutliner</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hypertext">hypertext</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hyperbole-Overview">Hyperbole Overview</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hypertext-1">hypertext</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Glossary">Glossary</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hypertext-2">hypertext</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Glossary">Glossary</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-HyRolo">HyRolo</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo">HyRolo</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-HyRolo-commands">HyRolo commands</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Menu">HyRolo Menu</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hyrolo-matches">hyrolo matches</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-HyRolo-Match-Buffers">Smart Key - HyRolo Match Buffers</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-HyRolo-menu">HyRolo menu</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Menu">HyRolo Menu</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hyrolo-menu">hyrolo menu</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Keys">HyRolo Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hywconfig-commands">hywconfig commands</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Window-Configurations">Window Configurations</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Concept-Index_cp_letter-I">I</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-ibtype">ibtype</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Programmatic-Implicit-Button-Types">Programmatic Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ibtype_002c-actype">ibtype, actype</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Programmatic-Implicit-Button-Types">Programmatic Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ibtype_002c-argument">ibtype, argument</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Programmatic-Implicit-Button-Types">Programmatic Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ibtype_002c-evaluation-order">ibtype, evaluation order</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Button-Type-Precedence">Button Type Precedence</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ibtype_002c-help">ibtype, help</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Programmatic-Implicit-Button-Types">Programmatic Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ibtype_002c-predicate">ibtype, predicate</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Programmatic-Implicit-Button-Types">Programmatic Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ibtype_002c-return-val">ibtype, return val</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Programmatic-Implicit-Button-Types">Programmatic Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ibtypes_002c-list-of">ibtypes, list of</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ibuffer-menu">ibuffer menu</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Mouse-Key-Modeline-Clicks">Smart Mouse Key Modeline Clicks</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ibuffer-menu-1">ibuffer menu</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Buffer-Menus">Smart Key - Buffer Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-idea-structuring">idea structuring</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-History">Koutliner History</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-idstamp">idstamp</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner">Koutliner</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-idstamp-1">idstamp</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Idstamps">Idstamps</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-idstamp-0">idstamp 0</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Idstamps">Idstamps</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-idstamp-attribute">idstamp attribute</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Cell-Attributes">Cell Attributes</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-idstamp-counter">idstamp counter</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Idstamps">Idstamps</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ilink">ilink</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-image-display">image display</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Referent-Display">Referent Display</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-images">images</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Image-Thumbnails">Smart Key - Image Thumbnails</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-implicit-action-button">implicit action button</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Action-Buttons">Action Buttons</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-implicit-button">implicit button</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Buttons">Buttons</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-implicit-button-1">implicit button</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Buttons">Implicit Buttons</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-implicit-button-labels">implicit button labels</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Buttons">Implicit Buttons</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-implicit-button-link">implicit button link</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-implicit-button-type">implicit button type</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Programmatic-Implicit-Button-Types">Programmatic Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-implicit-button-types">implicit button types</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-importing">importing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Inserting-and-Importing">Inserting and Importing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-importing-a-file">importing a file</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Inserting-and-Importing">Inserting and Importing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-inactive-minibuffer">inactive minibuffer</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Minibuffer-Menu-Activation">Minibuffer Menu Activation</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Info-browser">Info browser</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Mouse-Key-Modeline-Clicks">Smart Mouse Key Modeline Clicks</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Info-browsing">Info browsing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Info-Manuals">Smart Key - Info Manuals</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Info-manual">Info manual</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Invocation">Invocation</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Info-node">Info node</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-InfoDock">InfoDock</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Glossary">Glossary</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-inhibit-org_002dmode-support">inhibit org-mode support</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-initialization-file">initialization file</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Autonumbering">Autonumbering</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-insert-item">insert item</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Keyboard-Drags">Keyboard Drags</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-inserting-tabs">inserting tabs</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Relocating-and-Copying">Relocating and Copying</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-insertion">insertion</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Inserting-and-Importing">Inserting and Importing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-installation">installation</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Installation">Installation</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-instance-number">instance number</a>:</td><td>&nbsp;</td><td valign="top"><a href="#By-Menu">By Menu</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-interactive-cmd-char_002c-_002bI">interactive cmd char, +I</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Creating-Action-Types">Creating Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-interactive-cmd-char_002c-_002bK">interactive cmd char, +K</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Creating-Action-Types">Creating Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-interactive-cmd-char_002c-_002bL">interactive cmd char, +L</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Creating-Action-Types">Creating Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-interactive-cmd-char_002c-_002bM">interactive cmd char, +M</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Creating-Action-Types">Creating Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-interactive-cmd-char_002c-_002bV">interactive cmd char, +V</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Creating-Action-Types">Creating Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-interactive-cmd-char_002c-_002bX">interactive cmd char, +X</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Creating-Action-Types">Creating Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-interactive-computing">interactive computing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Glossary">Glossary</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-interactive-form">interactive form</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Creating-Action-Types">Creating Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-internal-custom-display">internal custom display</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Internal-Viewers">Internal Viewers</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-internal-display">internal display</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Referent-Display">Referent Display</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-internal-image-display">internal image display</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Internal-Viewers">Internal Viewers</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-internal-klink">internal klink</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Links">Links</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-internal-standard-display">internal standard display</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Internal-Viewers">Internal Viewers</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-internal-viewer">internal viewer</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Internal-Viewers">Internal Viewers</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Internet-RFC">Internet RFC</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Internet-RFC-1">Internet RFC</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-invoking-HyControl">invoking HyControl</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-invoking-Hyperbole">invoking Hyperbole</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ipython">ipython</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-isearch">isearch</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Invisible-Text-Searches">Invisible Text Searches</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-issue-tracking">issue tracking</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-item-drag">item drag</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Keyboard-Drags">Keyboard Drags</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-item-insert">item insert</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Keyboard-Drags">Keyboard Drags</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-item-throw">item throw</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Keyboard-Drags">Keyboard Drags</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Concept-Index_cp_letter-J">J</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-jump-menu">jump menu</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Mouse-Key-Modeline-Clicks">Smart Mouse Key Modeline Clicks</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-jump-menu-1">jump menu</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Minibuffer-Menu-Activation">Minibuffer Menu Activation</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-jump-to-window-by-letter">jump to window by letter</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Keyboard-Drags">Keyboard Drags</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Concept-Index_cp_letter-K">K</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-kcell-link">kcell link</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-key-binding-list">key binding list</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Global-Key-Bindings">Global Key Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-key-binding_002c-C_002dc-_002e">key binding, C-c .</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Default-Global-Bindings">Default Global Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-key-binding_002c-C_002dc-_0040">key binding, C-c @</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Default-Global-Bindings">Default Global Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-key-binding_002c-C_002dc-RET">key binding, C-c <tt class="key">RET</tt></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Default-Global-Bindings">Default Global Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-key-binding_002c-C_002dc-_005c">key binding, C-c \</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Default-Global-Bindings">Default Global Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-key-binding_002c-C_002dh-A">key binding, C-h A</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Default-Global-Bindings">Default Global Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-key-binding_002c-C_002dh-h">key binding, C-h h</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Default-Global-Bindings">Default Global Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-key-binding_002c-C_002du-C_002dh-A">key binding, C-u C-h A</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Default-Global-Bindings">Default Global Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-key-binding_002c-M_002do">key binding, M-o</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Default-Global-Bindings">Default Global Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-key-binding_002c-M_002dRET">key binding, M-<tt class="key">RET</tt></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Default-Global-Bindings">Default Global Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-key-binding_002c-menu">key binding, menu</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-key-binding_002c-smart-keys">key binding, smart keys</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Bindings">Smart Key Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-key-bindings_002c-toggle">key bindings, toggle</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Bindings">Smart Key Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-key-bindings_002c-toggle-1">key bindings, toggle</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Default-Global-Bindings">Default Global Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-key-sequence">key sequence</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-keyboard-drags">keyboard drags</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Keyboard-Drags">Keyboard Drags</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-keyboard_002c-jump-to-window">keyboard, jump to window</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Keyboard-Drags">Keyboard Drags</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-keypad">keypad</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kill-and-yank">kill and yank</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Thing-Selection">Thing Selection</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kill-and-yank-1">kill and yank</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Mouse-Drags-between-Windows">Smart Mouse Drags between Windows</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kill-and-yank-2">kill and yank</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Delimited-Things">Smart Key - Delimited Things</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-kill-region">kill region</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Thing-Selection">Smart Key Thing Selection</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-klink">klink</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-klink-1">klink</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Links">Links</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-klink-referent">klink referent</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Links">Links</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-klink_002c-activating">klink, activating</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Links">Links</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-klink_002c-external">klink, external</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Links">Links</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-klink_002c-formats">klink, formats</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Links">Links</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-klink_002c-inserting">klink, inserting</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Links">Links</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-klink_002c-internal">klink, internal</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Links">Links</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-klink_002c-view-spec">klink, view spec</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Links">Links</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-knowledge-transfer">knowledge transfer</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-History">Koutliner History</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-koutline-link">koutline link</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-koutline-mode">koutline mode</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Inserting-and-Importing">Inserting and Importing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Koutliner-commands">Koutliner commands</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menu-Commands">Menu Commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Koutliner-menu">Koutliner menu</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menu-Commands">Menu Commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Koutliner_002c-toggle-tab-behavior">Koutliner, toggle tab behavior</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Relocating-and-Copying">Relocating and Copying</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Concept-Index_cp_letter-L">L</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-label-separator_002c-changing">label separator, changing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Autonumbering">Autonumbering</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-label-separator_002c-default">label separator, default</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Autonumbering">Autonumbering</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-label-type">label type</a>:</td><td>&nbsp;</td><td valign="top"><a href="#View-Specs">View Specs</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-label-type_002c-alpha">label type, alpha</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Autonumbering">Autonumbering</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-label-type_002c-alpha-1">label type, alpha</a>:</td><td>&nbsp;</td><td valign="top"><a href="#View-Specs">View Specs</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-label-type_002c-changing">label type, changing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Autonumbering">Autonumbering</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-label-type_002c-idstamps">label type, idstamps</a>:</td><td>&nbsp;</td><td valign="top"><a href="#View-Specs">View Specs</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-label-type_002c-legal">label type, legal</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Autonumbering">Autonumbering</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-label-type_002c-legal-1">label type, legal</a>:</td><td>&nbsp;</td><td valign="top"><a href="#View-Specs">View Specs</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-label_002c-button">label, button</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Explicit-Buttons">Explicit Buttons</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-label_002c-button-1">label, button</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Global-Buttons">Global Buttons</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-labeling-implicit-buttons">labeling implicit buttons</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Buttons">Implicit Buttons</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-legal-labels">legal labels</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Autonumbering">Autonumbering</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-level">level</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hiding-and-Showing">Hiding and Showing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-level-1">level</a>:</td><td>&nbsp;</td><td valign="top"><a href="#View-Specs">View Specs</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-line-and-column">line and column</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-link">link</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Links">Links</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-link-action-types">link action types</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Action-Types">Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-link-button">link button</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Keyboard-Drags">Keyboard Drags</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-link-button-1">link button</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Explicit-Buttons">Explicit Buttons</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-link-creation">link creation</a>:</td><td>&nbsp;</td><td valign="top"><a href="#By-Dragging">By Dragging</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-link-display">link display</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Referent-Display">Referent Display</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-link-to-explicit-button">link to explicit button</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-link-to-global-button">link to global button</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-link-to-implicit-button">link to implicit button</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-link_002c-creation">link, creation</a>:</td><td>&nbsp;</td><td valign="top"><a href="#By-Menu">By Menu</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-link_002c-display-function">link, display function</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Internal-Viewers">Internal Viewers</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-link_002c-pathname">link, pathname</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-link_002c-pathname-line-and-column">link, pathname line and column</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-link_002c-viewer-program">link, viewer program</a>:</td><td>&nbsp;</td><td valign="top"><a href="#External-Viewers">External Viewers</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-link_002c-web-search">link, web search</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Action-Types">Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-linking_002c-in_002dplace">linking, in-place</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Explicit-Buttons">Explicit Buttons</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-links">links</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-lisp-identifier">lisp identifier</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Lisp-Source-Code">Smart Key - Lisp Source Code</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Lisp-variables">Lisp variables</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Lisp-variables-1">Lisp variables</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Link-Variable-Substitution">Link Variable Substitution</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-list">list</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Thing-Selection">Thing Selection</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-list-1">list</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Delimited-Things">Smart Key - Delimited Things</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-listing-attributes">listing attributes</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Cell-Attributes">Cell Attributes</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-locate-files">locate files</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-logging-Smart-Key-behavior">logging Smart Key behavior</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Debugging">Smart Key Debugging</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-logical-rolo-searches">logical rolo searches</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Searching">HyRolo Searching</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-lower-frame">lower frame</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Concept-Index_cp_letter-M">M</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-magit">magit</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Magit-Mode">Smart Key - Magit Mode</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-mail-address">mail address</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Cell-Attributes">Cell Attributes</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-mail-comment">mail comment</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Buttons-in-Mail">Buttons in Mail</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-mail-hooks">mail hooks</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hook-Variables">Hook Variables</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-mail-inclusion">mail inclusion</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Buttons-in-Mail">Buttons in Mail</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-mail-reader">mail reader</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Buttons-in-Mail">Buttons in Mail</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-mailer-initialization">mailer initialization</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Buttons-in-Mail">Buttons in Mail</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-mailing-an-outline">mailing an outline</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Relocating-and-Copying">Relocating and Copying</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-mailing-buttons">mailing buttons</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Buttons-in-Mail">Buttons in Mail</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-make-frame">make frame</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-make-window">make window</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-man-apropos">man apropos</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-man-page">man page</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Action-Types">Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-man-page-references">man page references</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Man-Pages">Smart Key - Man Pages</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-man-pages">man pages</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-margin">margin</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Filling">Filling</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-markdown-link">markdown link</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-markup-pair">markup pair</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Thing-Selection">Thing Selection</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-markup-pair-1">markup pair</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Delimited-Things">Smart Key - Delimited Things</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-match-lines">match lines</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-match-lines-1">match lines</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-match-lines-2">match lines</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-maximize-frame">maximize frame</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-maximize-window">maximize window</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu-help">menu help</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu-item-key-bindings">menu item key bindings</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu-item-selection">menu item selection</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu-item_002c-Act">menu item, Act</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu-item_002c-Activate_002dButton_002din_002dBuffer">menu item, Activate-Button-in-Buffer</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu-item_002c-Back_002dto_002dPrior_002dLocation">menu item, Back-to-Prior-Location</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu-item_002c-Cust_002fAll_002dOptions">menu item, Cust/All-Options</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Customization">Customization</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu-item_002c-Cust_002fDebug_002dToggle">menu item, Cust/Debug-Toggle</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Debugging">Smart Key Debugging</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu-item_002c-Cust_002fMsg_002dToggle_002dEbuts">menu item, Cust/Msg-Toggle-Ebuts</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Buttons-in-Mail">Buttons in Mail</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu-item_002c-Cust_002fMsg_002dToggle_002dEbuts-1">menu item, Cust/Msg-Toggle-Ebuts</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Buttons-in-News">Buttons in News</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu-item_002c-Doc_002fSmartKeys">menu item, Doc/SmartKeys</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Operations">Smart Key Operations</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu-item_002c-Find_002dFile_002dAccepts_002dURLs">menu item, Find-File-Accepts-URLs</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Using-URLs-with-Find_002dFile">Using URLs with Find-File</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu-item_002c-Find_002dFile_002dURLs">menu item, Find-File-URLs</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Using-URLs-with-Find_002dFile">Using URLs with Find-File</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu-item_002c-FramesControl">menu item, FramesControl</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu-item_002c-GrepFile">menu item, GrepFile</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu-item_002c-Hist">menu item, Hist</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu-item_002c-Ibut_002fAct">menu item, Ibut/Act</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Buttons">Implicit Buttons</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu-item_002c-Isearch_002dInvisible">menu item, Isearch-Invisible</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Invisible-Text-Searches">Invisible Text Searches</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu-item_002c-LocateFiles">menu item, LocateFiles</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu-item_002c-MatchFileBuffers">menu item, MatchFileBuffers</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu-item_002c-OccurHere">menu item, OccurHere</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu-item_002c-RegexFind">menu item, RegexFind</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Searching">HyRolo Searching</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu-item_002c-Remove_002dThis_002dMenu">menu item, Remove-This-Menu</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu-item_002c-RemoveLines">menu item, RemoveLines</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu-item_002c-SaveLines">menu item, SaveLines</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu-item_002c-StringFind">menu item, StringFind</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Searching">HyRolo Searching</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu-item_002c-Toggle_002dIsearch_002dInvisible">menu item, Toggle-Isearch-Invisible</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Invisible-Text-Searches">Invisible Text Searches</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu-item_002c-WindowsControl">menu item, WindowsControl</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu-item_002c-WordFind">menu item, WordFind</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Searching">HyRolo Searching</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu-prefix">menu prefix</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu-use">menu use</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu_002c-Butfile">menu, Butfile</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu_002c-Button_002dFile">menu, Button-File</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu_002c-Cust">menu, Cust</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu_002c-Cust-1">menu, Cust</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Customization">Customization</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu_002c-Cust_002fReferents">menu, Cust/Referents</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Internal-Viewers">Internal Viewers</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu_002c-Cust_002fURL_002dDisplay">menu, Cust/URL-Display</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Using-URLs-with-Find_002dFile">Using URLs with Find-File</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu_002c-Cust_002fURL_002dDisplay-1">menu, Cust/URL-Display</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-WWW-URLs">Smart Key - WWW URLs</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu_002c-Cust_002fWeb_002dSearch">menu, Cust/Web-Search</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Web-Search-Engines">Web Search Engines</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu_002c-Customize">menu, Customize</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu_002c-Doc">menu, Doc</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu_002c-Documentation">menu, Documentation</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu_002c-EBut">menu, EBut</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu_002c-Explicit_002dButton">menu, Explicit-Button</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu_002c-Find">menu, Find</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu_002c-Find_002fWeb">menu, Find/Web</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu_002c-Find_002fWeb-1">menu, Find/Web</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Web-Search-Engines">Web Search Engines</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu_002c-Find_002fWeb-2">menu, Find/Web</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Default-Global-Bindings">Default Global Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu_002c-Gbut">menu, Gbut</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Global-Buttons">Global Buttons</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu_002c-Gbut-1">menu, Gbut</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu_002c-Global_002dButton">menu, Global-Button</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Global-Buttons">Global Buttons</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu_002c-Global_002dButton-1">menu, Global-Button</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu_002c-HyRolo">menu, HyRolo</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Menu">HyRolo Menu</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu_002c-Ibut">menu, Ibut</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu_002c-Implicit_002dButton">menu, Implicit-Button</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu_002c-KeyBindings">menu, KeyBindings</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu_002c-Kotl">menu, Kotl</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu_002c-Koutline">menu, Koutline</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu_002c-Koutliner">menu, Koutliner</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menu-Commands">Menu Commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu_002c-Mail_002dLists">menu, Mail-Lists</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu_002c-Msg">menu, Msg</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu_002c-Outline_002fExample">menu, Outline/Example</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner">Koutliner</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu_002c-Outliner">menu, Outliner</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu_002c-Rolo">menu, Rolo</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu_002c-Rolo-1">menu, Rolo</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Menu">HyRolo Menu</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu_002c-Screen">menu, Screen</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu_002c-Toggle_002dRolo_002dDates">menu, Toggle-Rolo-Dates</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Keys">HyRolo Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu_002c-top_002dlevel">menu, top-level</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu_002c-top_002dlevel-1">menu, top-level</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Minibuffer-Menu-Activation">Minibuffer Menu Activation</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu_002c-Types">menu, Types</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu_002c-Web">menu, Web</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu_002c-Web-1">menu, Web</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Web-Search-Engines">Web Search Engines</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu_002c-Web-2">menu, Web</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Default-Global-Bindings">Default Global Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu_002c-WinConfig">menu, WinConfig</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menu_002c-Window_002dConfigurations">menu, Window-Configurations</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menubar-menu_002c-HyRolo">menubar menu, HyRolo</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Menu">HyRolo Menu</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menubar-menu_002c-Koutliner">menubar menu, Koutliner</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menu-Commands">Menu Commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menubar-menu_002c-Rolo">menubar menu, Rolo</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Menu">HyRolo Menu</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-menubar_002c-Hyperbole-menu">menubar, Hyperbole menu</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Messages-buffer">Messages buffer</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Debugging">Smart Key Debugging</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-MH_002de">MH-e</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Buttons-in-Mail">Buttons in Mail</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-middle-mouse-key">middle mouse key</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Keys">Smart Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-minibuffer-menu">minibuffer menu</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-minibuffer-menu-1">minibuffer menu</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Minibuffer-Menu-Activation">Minibuffer Menu Activation</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-minibuffer-menu-bindings">minibuffer menu bindings</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Binding-Minibuffer-Menu-Items">Binding Minibuffer Menu Items</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-minibuffer-menus">minibuffer menus</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-minibuffer_002c-buffer-menu">minibuffer, buffer menu</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Minibuffer-Menu-Activation">Minibuffer Menu Activation</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-minibuffer_002c-default-actions">minibuffer, default actions</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Minibuffer-Menu-Activation">Minibuffer Menu Activation</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-minibuffer_002c-jump-menu">minibuffer, jump menu</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Minibuffer-Menu-Activation">Minibuffer Menu Activation</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-modeline-click">modeline click</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Modeline-Clicks-and-Drags">Modeline Clicks and Drags</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-modeline-click-and-drag">modeline click and drag</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Mouse-Key-Modeline-Clicks">Smart Mouse Key Modeline Clicks</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-modeline-drag">modeline drag</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Modeline-Clicks-and-Drags">Modeline Clicks and Drags</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-modeline-drag_002c-move-frame">modeline drag, move frame</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Moving-Frames">Moving Frames</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-modeline_002c-buffer-id">modeline, buffer id</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Mouse-Key-Modeline-Clicks">Smart Mouse Key Modeline Clicks</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-modeline_002c-buffer-menu">modeline, buffer menu</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Mouse-Key-Modeline-Clicks">Smart Mouse Key Modeline Clicks</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-modeline_002c-bury-buffer">modeline, bury buffer</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Mouse-Key-Modeline-Clicks">Smart Mouse Key Modeline Clicks</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-modeline_002c-dired">modeline, dired</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Mouse-Key-Modeline-Clicks">Smart Mouse Key Modeline Clicks</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-modeline_002c-Info-Browser">modeline, Info Browser</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Mouse-Key-Modeline-Clicks">Smart Mouse Key Modeline Clicks</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-modeline_002c-jump-menu">modeline, jump menu</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Mouse-Key-Modeline-Clicks">Smart Mouse Key Modeline Clicks</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-modeline_002c-leftmost-character">modeline, leftmost character</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Mouse-Key-Modeline-Clicks">Smart Mouse Key Modeline Clicks</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-modeline_002c-next-buffer">modeline, next buffer</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Mouse-Key-Modeline-Clicks">Smart Mouse Key Modeline Clicks</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-modeline_002c-prev-buffer">modeline, prev buffer</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Mouse-Key-Modeline-Clicks">Smart Mouse Key Modeline Clicks</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-modeline_002c-screen-command-menu">modeline, screen command menu</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Mouse-Key-Modeline-Clicks">Smart Mouse Key Modeline Clicks</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-modeline_002c-Smart-Keys">modeline, Smart Keys</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Operations">Smart Key Operations</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-modeline_002c-unbury-buffer">modeline, unbury buffer</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Mouse-Key-Modeline-Clicks">Smart Mouse Key Modeline Clicks</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-modeline_002c-view-spec">modeline, view spec</a>:</td><td>&nbsp;</td><td valign="top"><a href="#View-Specs">View Specs</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-mouse">mouse</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Glossary">Glossary</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-mouse-bindings">mouse bindings</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-mouse-drag_002c-link-creation">mouse drag, link creation</a>:</td><td>&nbsp;</td><td valign="top"><a href="#By-Dragging">By Dragging</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-mouse-key-bindings">mouse key bindings</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Questions-and-Answers">Questions and Answers</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-mouse-key-toggle">mouse key toggle</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Default-Global-Bindings">Default Global Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-mouse-keys_002c-unshifted">mouse keys, unshifted</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Bindings">Smart Key Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-mouse-support">mouse support</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Keys">Smart Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-mouse_002c-moving-trees">mouse, moving trees</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Relocating-and-Copying">Relocating and Copying</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-move-window">move window</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Mouse-Drags-outside-a-Window">Smart Mouse Drags outside a Window</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-moving-buttons">moving buttons</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Explicit-Buttons">Explicit Buttons</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-moving-frames">moving frames</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Moving-Frames">Moving Frames</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-multiplier">multiplier</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Concept-Index_cp_letter-N">N</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-name_002c-button">name, button</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Explicit-Buttons">Explicit Buttons</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-named-window-configuration">named window configuration</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Window-Configurations">Window Configurations</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-naming-implicit-buttons">naming implicit buttons</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Buttons">Implicit Buttons</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-news">news</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Buttons-in-Mail">Buttons in Mail</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-news-comment">news comment</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Buttons-in-News">Buttons in News</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-news-hooks">news hooks</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hook-Variables">Hook Variables</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-news-reader_002fposter">news reader/poster</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Buttons-in-News">Buttons in News</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-NLS">NLS</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-History">Koutliner History</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-no_002dfill-attribute">no-fill attribute</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Cell-Attributes">Cell Attributes</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-normalized-label">normalized label</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Button-Label-Normalization">Button Label Normalization</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-numeric-argument">numeric argument</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-numeric-keypad">numeric keypad</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Concept-Index_cp_letter-O">O</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-object_002doriented-code-browsing">object-oriented code browsing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-The-OO_002dBrowser">Smart Key - The OO-Browser</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-obtaining-Hyperbole">obtaining Hyperbole</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Installation">Installation</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-online-library">online library</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-OO_002dBrowser">OO-Browser</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-The-OO_002dBrowser">Smart Key - The OO-Browser</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-option-setting">option setting</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Customization">Customization</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-option-settings">option settings</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Org_002dmode">Org-mode</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Org_002dmode-1">Org-mode</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Questions-and-Answers">Questions and Answers</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-other-frame">other frame</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-other-window">other window</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-outline-file-suffix">outline file suffix</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Creating-Outlines">Creating Outlines</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-outline-mode">outline mode</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Inserting-and-Importing">Inserting and Importing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-outline-processor">outline processor</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Glossary">Glossary</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-outline-structure">outline structure</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Autonumbering">Autonumbering</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-outline_002c-all-cells">outline, all cells</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hiding-and-Showing">Hiding and Showing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-outline_002c-attribute-list">outline, attribute list</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Cell-Attributes">Cell Attributes</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-outline_002c-conversion">outline, conversion</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Inserting-and-Importing">Inserting and Importing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-outline_002c-creating">outline, creating</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Creating-Outlines">Creating Outlines</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-outline_002c-exporting">outline, exporting</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Relocating-and-Copying">Relocating and Copying</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-outline_002c-exporting-from">outline, exporting from</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Exporting">Exporting</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-outline_002c-filling">outline, filling</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Filling">Filling</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-outline_002c-foreign-file">outline, foreign file</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Inserting-and-Importing">Inserting and Importing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-outline_002c-hiding">outline, hiding</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hiding-and-Showing">Hiding and Showing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-outline_002c-HTML-conversion">outline, HTML conversion</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Exporting">Exporting</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-outline_002c-importing">outline, importing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Relocating-and-Copying">Relocating and Copying</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-outline_002c-importing-into">outline, importing into</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Inserting-and-Importing">Inserting and Importing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-outline_002c-inserting-into">outline, inserting into</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Inserting-and-Importing">Inserting and Importing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-outline_002c-label-separator">outline, label separator</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Autonumbering">Autonumbering</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-outline_002c-label-type">outline, label type</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Autonumbering">Autonumbering</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-outline_002c-mailing">outline, mailing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Relocating-and-Copying">Relocating and Copying</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-outline_002c-motion">outline, motion</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Moving-Around">Moving Around</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-outline_002c-overview">outline, overview</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hiding-and-Showing">Hiding and Showing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-outline_002c-show-levels">outline, show levels</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hiding-and-Showing">Hiding and Showing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-outline_002c-showing">outline, showing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hiding-and-Showing">Hiding and Showing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-outline_002c-top_002dlevel">outline, top-level</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hiding-and-Showing">Hiding and Showing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-outline_002c-view-specs">outline, view specs</a>:</td><td>&nbsp;</td><td valign="top"><a href="#View-Specs">View Specs</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-outline_002c-viewing">outline, viewing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Viewing">Viewing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-outline_002dminor_002dmode">outline-minor-mode</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Emacs-Outline-Mode">Smart Key - Emacs Outline Mode</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-outline_002dmode">outline-mode</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Emacs-Outline-Mode">Smart Key - Emacs Outline Mode</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-outliner">outliner</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner">Koutliner</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-outliner-commands">outliner commands</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menu-Commands">Menu Commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-outliner-keys">outliner keys</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner-Keys">Koutliner Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-overriding-local-keys">overriding local keys</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Default-Global-Bindings">Default Global Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-overview">overview</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hiding-and-Showing">Hiding and Showing</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Concept-Index_cp_letter-P">P</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-paragraph_002c-filling">paragraph, filling</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Filling">Filling</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-paste-region">paste region</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Thing-Selection">Smart Key Thing Selection</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-pasting-a-region">pasting a region</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Thing-Selection">Thing Selection</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-pasting-a-region-1">pasting a region</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Mouse-Drags-between-Windows">Smart Mouse Drags between Windows</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-pasting-a-region-2">pasting a region</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Delimited-Things">Smart Key - Delimited Things</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-patch-output">patch output</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-pathname">pathname</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-pathname_002c-line-and-column">pathname, line and column</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-permanent-identifier">permanent identifier</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner">Koutliner</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-permanent-identifier-1">permanent identifier</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Idstamps">Idstamps</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-pipe-character">pipe character</a>:</td><td>&nbsp;</td><td valign="top"><a href="#View-Specs">View Specs</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-popup-menu">popup menu</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-popup-menu_002c-HyRolo">popup menu, HyRolo</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Menu">HyRolo Menu</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-popup-menu_002c-Koutliner">popup menu, Koutliner</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menu-Commands">Menu Commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-popup-menu_002c-Rolo">popup menu, Rolo</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Menu">HyRolo Menu</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-posting-buttons">posting buttons</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Buttons-in-Mail">Buttons in Mail</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-posting-news">posting news</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Buttons-in-News">Buttons in News</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-precedence_002c-buttons">precedence, buttons</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Button-Type-Precedence">Button Type Precedence</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-programming-interface">programming interface</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Embedding-Hyperbole">Embedding Hyperbole</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-promotion">promotion</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Relocating-and-Copying">Relocating and Copying</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-proportional-scrolling">proportional scrolling</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Glossary">Glossary</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-proportional-scrolling-1">proportional scrolling</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Smart-Scrolling">Smart Key - Smart Scrolling</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-pulldown-menu">pulldown menu</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Concept-Index_cp_letter-Q">Q</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-quit-HyControl">quit HyControl</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Concept-Index_cp_letter-R">R</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-radio-target">radio target</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-raise-frame">raise frame</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-rdb_002dmode">rdb-mode</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-RDB-Mode">Smart Key - RDB Mode</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-rebalance-windows">rebalance windows</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Creating-and-Deleting-Windows">Creating and Deleting Windows</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-reference">reference</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-referent">referent</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Explicit-Buttons">Explicit Buttons</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-referent-display">referent display</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Referent-Display">Referent Display</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-refilling">refilling</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Filling">Filling</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-region-selection">region selection</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Thing-Selection">Smart Key Thing Selection</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-region-throw">region throw</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Keyboard-Drags">Keyboard Drags</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-region_002c-active">region, active</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Mouse-Drags-within-a-Window">Smart Mouse Drags within a Window</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-relative-autonumber">relative autonumber</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Koutliner">Koutliner</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-relative-identifier">relative identifier</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Autonumbering">Autonumbering</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-remote-file">remote file</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-remote-path">remote path</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-remote-pathnames">remote pathnames</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Using-URLs-with-Find_002dFile">Using URLs with Find-File</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-remove-lines">remove lines</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-removing-Hyperbole-menu">removing Hyperbole menu</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-replace-window-buffer">replace window buffer</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Keyboard-Drags">Keyboard Drags</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Request-For-Comment">Request For Comment</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Request-For-Comment-1">Request For Comment</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-resize-frame-percentage">resize frame percentage</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-resizing-windows">resizing windows</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Resizing-Windows">Resizing Windows</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-restoring-windows">restoring windows</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Window-Configurations">Window Configurations</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-RFC">RFC</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-RFC-1">RFC</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ripgrep">ripgrep</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Rmail">Rmail</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Buttons-in-Mail">Buttons in Mail</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Rolo">Rolo</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo">HyRolo</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-rolo-address">rolo address</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Rolo-commands">Rolo commands</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Menu">HyRolo Menu</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-rolo-entry">rolo entry</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Concepts">HyRolo Concepts</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-rolo-file">rolo file</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Concepts">HyRolo Concepts</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-rolo-keys">rolo keys</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Keys">HyRolo Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Rolo-menu">Rolo menu</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Menu">HyRolo Menu</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-rolo-searching">rolo searching</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Searching">HyRolo Searching</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-rolo_002c-buttons-in">rolo, buttons in</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo">HyRolo</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-rolo_002c-datestamps">rolo, datestamps</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Keys">HyRolo Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-rolo_002c-editing">rolo, editing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Keys">HyRolo Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-rolo_002c-extending-a-match">rolo, extending a match</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Keys">HyRolo Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-rolo_002c-finding-matches">rolo, finding matches</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Keys">HyRolo Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-rolo_002c-highlighting-matches">rolo, highlighting matches</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Keys">HyRolo Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-rolo_002c-highlighting-matches-1">rolo, highlighting matches</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Settings">HyRolo Settings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-rolo_002c-interactive-searching">rolo, interactive searching</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Keys">HyRolo Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-rolo_002c-locating-a-name">rolo, locating a name</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Keys">HyRolo Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-rolo_002c-moving-through-matches">rolo, moving through matches</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Keys">HyRolo Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-rolo_002c-moving-to-entries">rolo, moving to entries</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Keys">HyRolo Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-rolo_002c-outlining">rolo, outlining</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Keys">HyRolo Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-rolo_002c-personal">rolo, personal</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Settings">HyRolo Settings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-rolo_002c-quitting">rolo, quitting</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Keys">HyRolo Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-root-cell">root cell</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Creating-Outlines">Creating Outlines</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-root-cell-1">root cell</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Idstamps">Idstamps</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Concept-Index_cp_letter-S">S</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-save-lines">save lines</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-saving-window-configurations">saving window configurations</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Window-Configurations">Window Configurations</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-screen">screen</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Screen">Screen</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Glossary">Glossary</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-screen_002c-edge-offsets">screen, edge offsets</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-scrolling">scrolling</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Glossary">Glossary</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-scrolling-1">scrolling</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Smart-Scrolling">Smart Key - Smart Scrolling</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-search">search</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-search-1">search</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Invisible-Text-Searches">Invisible Text Searches</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-search-engines-menu">search engines menu</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Web-Search-Engines">Web Search Engines</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-searching-the-web">searching the web</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-searching-the-web-1">searching the web</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Default-Global-Bindings">Default Global Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-searching_002c-rolo">searching, rolo</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyRolo-Searching">HyRolo Searching</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-selection">selection</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Thing-Selection">Smart Key Thing Selection</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-selection_002c-menu-items">selection, menu items</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-sequence-of-keys">sequence of keys</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-set">set</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Thing-Selection">Thing Selection</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-set-1">set</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Delimited-Things">Smart Key - Delimited Things</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-setting-the-view-spec">setting the view spec</a>:</td><td>&nbsp;</td><td valign="top"><a href="#View-Specs">View Specs</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-sexp-selection">sexp selection</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Thing-Selection">Smart Key Thing Selection</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-SGML-tag-pair">SGML tag pair</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Thing-Selection">Smart Key Thing Selection</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-show-subtree">show subtree</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hiding-and-Showing">Hiding and Showing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-show-tree">show tree</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hiding-and-Showing">Hiding and Showing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-showing">showing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hiding-and-Showing">Hiding and Showing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-shrink-frame">shrink frame</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-shrink-window">shrink window</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-side-drag">side drag</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Side_002dby_002dSide-Window-Resizing">Side-by-Side Window Resizing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-signatures_002c-hiding">signatures, hiding</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Smart-Key">Smart Key</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Keys">Smart Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Smart-Key-1">Smart Key</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Glossary">Glossary</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Smart-Key-2">Smart Key</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Questions-and-Answers">Questions and Answers</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-smart-key-assignments">smart key assignments</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Bindings">Smart Key Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-smart-key-commands">smart key commands</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Bindings">Smart Key Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Smart-Key-debugging">Smart Key debugging</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Debugging">Smart Key Debugging</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Smart-Key-help">Smart Key help</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Operations">Smart Key Operations</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Smart-Key-operation">Smart Key operation</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Operations">Smart Key Operations</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Smart-Key-summary">Smart Key summary</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Operations">Smart Key Operations</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Smart-Key_002c-default-context">Smart Key, default context</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Operations">Smart Key Operations</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Smart-Key_002c-default-context-1">Smart Key, default context</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Default-Context">Smart Key - Default Context</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Smart-Keyboard-Keys">Smart Keyboard Keys</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Argument-Completion">Smart Key - Argument Completion</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-smart-keys_002c-unshifted">smart keys, unshifted</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Bindings">Smart Key Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-smart-marking">smart marking</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Thing-Selection">Smart Key Thing Selection</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Smart-Menu">Smart Menu</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Smart-Menus">Smart Key - Smart Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Smart-Mouse-Key">Smart Mouse Key</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Thing-Selection">Thing Selection</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Smart-Mouse-Key-1">Smart Mouse Key</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Delimited-Things">Smart Key - Delimited Things</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-smart-mouse-key-drag">smart mouse key drag</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Mouse-Key-Drags">Smart Mouse Key Drags</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Smart-Mouse-Key-drag">Smart Mouse Key drag</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Modification">Modification</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Smart-Mouse-Key-toggle">Smart Mouse Key toggle</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Default-Global-Bindings">Default Global Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Smart-Mouse-Keys">Smart Mouse Keys</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Mouse-Keys">Smart Mouse Keys</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-smart-selection">smart selection</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Thing-Selection">Smart Key Thing Selection</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-social-media">social media</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-social-reference">social reference</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-source-line">source line</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-splitting-a-cell">splitting a cell</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Splitting-and-Appending">Splitting and Appending</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-stack-frame">stack frame</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-stack-frame-1">stack frame</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-star-outline">star outline</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Inserting-and-Importing">Inserting and Importing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-starting-HyControl">starting HyControl</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-starting-Hyperbole">starting Hyperbole</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-storage-manager">storage manager</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Operational-and-Storage-Formats">Operational and Storage Formats</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-string">string</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Thing-Selection">Thing Selection</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-string-1">string</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Delimited-Things">Smart Key - Delimited Things</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-submenus">submenus</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-submodes">submodes</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-subtree_002c-hide">subtree, hide</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hiding-and-Showing">Hiding and Showing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-subtree_002c-show">subtree, show</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hiding-and-Showing">Hiding and Showing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-swap-buffers">swap buffers</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Swapping-Buffers">Swapping Buffers</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-swap-window-buffers">swap window buffers</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Keyboard-Drags">Keyboard Drags</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-swapping">swapping</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-system-encapsulation">system encapsulation</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Encapsulating-Systems">Encapsulating Systems</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Concept-Index_cp_letter-T">T</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-table-of-contents">table of contents</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-table-of-contents-1">table of contents</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-table-of-contents-2">table of contents</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Action-Types">Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-tabs_002c-inserting">tabs, inserting</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Relocating-and-Copying">Relocating and Copying</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-tag">tag</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-TAGS-file">TAGS file</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-tags-file">tags file</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-tar-archive-browsing">tar archive browsing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Tar-File-Mode">Smart Key - Tar File Mode</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-terminal-use">terminal use</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Buttons">Buttons</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Texinfo-cross_002dreference">Texinfo cross-reference</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Texinfo-manual">Texinfo manual</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Invocation">Invocation</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-text-file">text file</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Inserting-and-Importing">Inserting and Importing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-thing">thing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Thing-Selection">Thing Selection</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-thing-1">thing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Delimited-Things">Smart Key - Delimited Things</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-things">things</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Thing-Selection">Smart Key Thing Selection</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-throw-item">throw item</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Keyboard-Drags">Keyboard Drags</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-throw-region">throw region</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Keyboard-Drags">Keyboard Drags</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-thumbnails">thumbnails</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Image-Thumbnails">Smart Key - Image Thumbnails</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-toc-action-type">toc action type</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Action-Types">Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-toc-implicit-button-type">toc implicit button type</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-toggle-HyControl-mode">toggle HyControl mode</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-toggle-key-bindings">toggle key bindings</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Bindings">Smart Key Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-toggle-key-bindings-1">toggle key bindings</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Default-Global-Bindings">Default Global Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-toggling-blank-lines">toggling blank lines</a>:</td><td>&nbsp;</td><td valign="top"><a href="#View-Specs">View Specs</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-top_002dlevel-cell">top-level cell</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Creating-Outlines">Creating Outlines</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-top_002dlevel-cell-1">top-level cell</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Idstamps">Idstamps</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-top_002dlevel-menu">top-level menu</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-top_002dlevel-view">top-level view</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hiding-and-Showing">Hiding and Showing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Tramp">Tramp</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Tramp-1">Tramp</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Using-URLs-with-Find_002dFile">Using URLs with Find-File</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-transposing-cells">transposing cells</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Transposing">Transposing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-tree_002c-copying">tree, copying</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Relocating-and-Copying">Relocating and Copying</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-tree_002c-demoting">tree, demoting</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Relocating-and-Copying">Relocating and Copying</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-tree_002c-exporting">tree, exporting</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Relocating-and-Copying">Relocating and Copying</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-tree_002c-filling">tree, filling</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Filling">Filling</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-tree_002c-hide-subtree">tree, hide subtree</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hiding-and-Showing">Hiding and Showing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-tree_002c-killing">tree, killing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Adding-and-Killing">Adding and Killing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-tree_002c-mailing">tree, mailing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Relocating-and-Copying">Relocating and Copying</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-tree_002c-moving">tree, moving</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Relocating-and-Copying">Relocating and Copying</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-tree_002c-promoting">tree, promoting</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Relocating-and-Copying">Relocating and Copying</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-tree_002c-show">tree, show</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hiding-and-Showing">Hiding and Showing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-tree_002c-show-1">tree, show</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hiding-and-Showing">Hiding and Showing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-tree_002c-show-subtree">tree, show subtree</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hiding-and-Showing">Hiding and Showing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Treemacs">Treemacs</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Mouse-Key-Modeline-Clicks">Smart Mouse Key Modeline Clicks</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Treemacs-1">Treemacs</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Treemacs">Smart Key - Treemacs</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-Treemacs-item-drag">Treemacs item drag</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Displaying-File-and-Buffer-Items">Displaying File and Buffer Items</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-troubleshooting-Smart-Keys">troubleshooting Smart Keys</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Debugging">Smart Key Debugging</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-tutorial">tutorial</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Manual-Overview">Manual Overview</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-type-definition">type definition</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Creating-Types">Creating Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-type-redefinition">type redefinition</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Button-Type-Precedence">Button Type Precedence</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-type-redefinition-1">type redefinition</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Creating-Types">Creating Types</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Concept-Index_cp_letter-U">U</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-unbury-buffer">unbury buffer</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Mouse-Key-Modeline-Clicks">Smart Mouse Key Modeline Clicks</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-unburying">unburying</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-UNIX-manual">UNIX manual</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-unshifted-mouse-bindings">unshifted mouse bindings</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Bindings">Smart Key Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-unshifted-mouse-keys">unshifted mouse keys</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Bindings">Smart Key Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-URL">URL</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-URL-1">URL</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Action-Types">Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-URL-2">URL</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-WWW-URLs">Smart Key - WWW URLs</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-URLs_002c-abbreviated">URLs, abbreviated</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Using-URLs-with-Find_002dFile">Using URLs with Find-File</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-URLs_002c-using-with-find_002dfile">URLs, using with find-file</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Using-URLs-with-Find_002dFile">Using URLs with Find-File</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-USENET">USENET</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Buttons-in-Mail">Buttons in Mail</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-USENET-1">USENET</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Buttons-in-News">Buttons in News</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-username">username</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Concept-Index_cp_letter-V">V</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-variable-display-implicit-button">variable display implicit button</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-variable-setting">variable setting</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Customization">Customization</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-variables">variables</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hook-Variables">Hook Variables</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-vector">vector</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Thing-Selection">Thing Selection</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-vector-1">vector</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Delimited-Things">Smart Key - Delimited Things</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-version-control">version control</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-version-control-1">version control</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-version-control-2">version control</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-version-control-3">version control</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-version-description">version description</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Suggestion-or-Bug-Reporting">Suggestion or Bug Reporting</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-vertical-drag">vertical drag</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Creating-and-Deleting-Windows">Creating and Deleting Windows</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-vertical-drag-1">vertical drag</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Mouse-Drags-within-a-Window">Smart Mouse Drags within a Window</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-view">view</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Viewing">Viewing</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-view-mode">view mode</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-View-Mode">Smart Key - View Mode</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-view-spec">view spec</a>:</td><td>&nbsp;</td><td valign="top"><a href="#View-Specs">View Specs</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-view-spec-klink">view spec klink</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Links">Links</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-view-spec_002c-all-lines-and-levels">view spec, all lines and levels</a>:</td><td>&nbsp;</td><td valign="top"><a href="#View-Specs">View Specs</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-view-spec_002c-blank-lines">view spec, blank lines</a>:</td><td>&nbsp;</td><td valign="top"><a href="#View-Specs">View Specs</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-view-spec_002c-changing">view spec, changing</a>:</td><td>&nbsp;</td><td valign="top"><a href="#View-Specs">View Specs</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-view-spec_002c-characters">view spec, characters</a>:</td><td>&nbsp;</td><td valign="top"><a href="#View-Specs">View Specs</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-view-spec_002c-ellipses">view spec, ellipses</a>:</td><td>&nbsp;</td><td valign="top"><a href="#View-Specs">View Specs</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-view-spec_002c-example">view spec, example</a>:</td><td>&nbsp;</td><td valign="top"><a href="#View-Specs">View Specs</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-view-spec_002c-label-type">view spec, label type</a>:</td><td>&nbsp;</td><td valign="top"><a href="#View-Specs">View Specs</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-view-spec_002c-lines-per-cell">view spec, lines per cell</a>:</td><td>&nbsp;</td><td valign="top"><a href="#View-Specs">View Specs</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-view-spec_002c-setting">view spec, setting</a>:</td><td>&nbsp;</td><td valign="top"><a href="#View-Specs">View Specs</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-view-spec_002c-show-levels">view spec, show levels</a>:</td><td>&nbsp;</td><td valign="top"><a href="#View-Specs">View Specs</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-virtual-numeric-keypad">virtual numeric keypad</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-VM">VM</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Buttons-in-Mail">Buttons in Mail</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Concept-Index_cp_letter-W">W</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-W3">W3</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-WWW-URLs">Smart Key - WWW URLs</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-wconfig-commands">wconfig commands</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Window-Configurations">Window Configurations</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-web-pages_002c-displaying">web pages, displaying</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Using-URLs-with-Find_002dFile">Using URLs with Find-File</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-web-search">web search</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Menus">Menus</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-web-search-link">web search link</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Action-Types">Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-web-search-menu">web search menu</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Web-Search-Engines">Web Search Engines</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-web-search-menu-1">web search menu</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Default-Global-Bindings">Default Global Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-where-to-display">where to display</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Referent-Display">Referent Display</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-window-by-letter">window by letter</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Keyboard-Drags">Keyboard Drags</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-window-configuration">window configuration</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-window-configuration-commands">window configuration commands</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Window-Configurations">Window Configurations</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-window-configuration-drag">window configuration drag</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Saving-and-Restoring-Window-Configurations">Saving and Restoring Window Configurations</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-window-configuration-ring">window configuration ring</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Window-Configurations">Window Configurations</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-window-configurations">window configurations</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Window-Configurations">Window Configurations</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-window-link-button">window link button</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Keyboard-Drags">Keyboard Drags</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-window-system">window system</a>:</td><td>&nbsp;</td><td valign="top"><a href="#External-Viewers">External Viewers</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-window_002c-clone">window, clone</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Cloning-Windows">Cloning Windows</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-window_002c-clone-1">window, clone</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-window_002c-clone-2">window, clone</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Mouse-Drags-outside-a-Window">Smart Mouse Drags outside a Window</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-window_002c-make">window, make</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-window_002c-maximize">window, maximize</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-window_002c-move">window, move</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Mouse-Drags-outside-a-Window">Smart Mouse Drags outside a Window</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-window_002c-other">window, other</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-window_002c-shrink">window, shrink</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-window_002c-swap-buffer">window, swap buffer</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Swapping-Buffers">Swapping Buffers</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-window_002c-zoom">window, zoom</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-windows">windows</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Glossary">Glossary</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-windows-control">windows control</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-windows-grid">windows grid</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-windows-grid-1">windows grid</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Default-Global-Bindings">Default Global Bindings</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-windows_002c-balance">windows, balance</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-windows_002c-equalize">windows, equalize</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-windows_002c-rebalance">windows, rebalance</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Creating-and-Deleting-Windows">Creating and Deleting Windows</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-word-wrap">word wrap</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Filling">Filling</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-World_002dwide-Web">World-wide Web</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-World_002dwide-Web-1">World-wide Web</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Action-Types">Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-World_002dwide-Web-2">World-wide Web</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-WWW-URLs">Smart Key - WWW URLs</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-WWW">WWW</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-WWW-1">WWW</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Action-Types">Action Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-WWW-2">WWW</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-WWW-URLs">Smart Key - WWW URLs</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Concept-Index_cp_letter-X">X</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-xdb">xdb</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Implicit-Button-Types">Implicit Button Types</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-XML-tag-pair">XML tag pair</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Thing-Selection">Smart Key Thing Selection</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Concept-Index_cp_letter-Y">Y</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-yank-region">yank region</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-Thing-Selection">Smart Key Thing Selection</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-yank_002c-reformatting">yank, reformatting</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Hook-Variables">Hook Variables</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-yanking">yanking</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Thing-Selection">Thing Selection</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-yanking-1">yanking</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Mouse-Drags-between-Windows">Smart Mouse Drags between Windows</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-yanking-2">yanking</a>:</td><td>&nbsp;</td><td valign="top"><a href="#Smart-Key-_002d-Delimited-Things">Smart Key - Delimited Things</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Concept-Index_cp_letter-Z">Z</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-zooming">zooming</a>:</td><td>&nbsp;</td><td valign="top"><a href="#HyControl">HyControl</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
</table>
<table><tr><th valign="top">Jump to: &nbsp; </th><td><a class="summary-letter" href="#Concept-Index_cp_symbol-1"><b>&lt;</b></a>
 &nbsp; 
<a class="summary-letter" href="#Concept-Index_cp_symbol-2"><b>|</b></a>
 &nbsp; 
<br>
<a class="summary-letter" href="#Concept-Index_cp_letter-A"><b>A</b></a>
 &nbsp; 
<a class="summary-letter" href="#Concept-Index_cp_letter-B"><b>B</b></a>
 &nbsp; 
<a class="summary-letter" href="#Concept-Index_cp_letter-C"><b>C</b></a>
 &nbsp; 
<a class="summary-letter" href="#Concept-Index_cp_letter-D"><b>D</b></a>
 &nbsp; 
<a class="summary-letter" href="#Concept-Index_cp_letter-E"><b>E</b></a>
 &nbsp; 
<a class="summary-letter" href="#Concept-Index_cp_letter-F"><b>F</b></a>
 &nbsp; 
<a class="summary-letter" href="#Concept-Index_cp_letter-G"><b>G</b></a>
 &nbsp; 
<a class="summary-letter" href="#Concept-Index_cp_letter-H"><b>H</b></a>
 &nbsp; 
<a class="summary-letter" href="#Concept-Index_cp_letter-I"><b>I</b></a>
 &nbsp; 
<a class="summary-letter" href="#Concept-Index_cp_letter-J"><b>J</b></a>
 &nbsp; 
<a class="summary-letter" href="#Concept-Index_cp_letter-K"><b>K</b></a>
 &nbsp; 
<a class="summary-letter" href="#Concept-Index_cp_letter-L"><b>L</b></a>
 &nbsp; 
<a class="summary-letter" href="#Concept-Index_cp_letter-M"><b>M</b></a>
 &nbsp; 
<a class="summary-letter" href="#Concept-Index_cp_letter-N"><b>N</b></a>
 &nbsp; 
<a class="summary-letter" href="#Concept-Index_cp_letter-O"><b>O</b></a>
 &nbsp; 
<a class="summary-letter" href="#Concept-Index_cp_letter-P"><b>P</b></a>
 &nbsp; 
<a class="summary-letter" href="#Concept-Index_cp_letter-Q"><b>Q</b></a>
 &nbsp; 
<a class="summary-letter" href="#Concept-Index_cp_letter-R"><b>R</b></a>
 &nbsp; 
<a class="summary-letter" href="#Concept-Index_cp_letter-S"><b>S</b></a>
 &nbsp; 
<a class="summary-letter" href="#Concept-Index_cp_letter-T"><b>T</b></a>
 &nbsp; 
<a class="summary-letter" href="#Concept-Index_cp_letter-U"><b>U</b></a>
 &nbsp; 
<a class="summary-letter" href="#Concept-Index_cp_letter-V"><b>V</b></a>
 &nbsp; 
<a class="summary-letter" href="#Concept-Index_cp_letter-W"><b>W</b></a>
 &nbsp; 
<a class="summary-letter" href="#Concept-Index_cp_letter-X"><b>X</b></a>
 &nbsp; 
<a class="summary-letter" href="#Concept-Index_cp_letter-Y"><b>Y</b></a>
 &nbsp; 
<a class="summary-letter" href="#Concept-Index_cp_letter-Z"><b>Z</b></a>
 &nbsp; 
</td></tr></table>

<hr>



</body>
</html>
